qlogicagent 2.16.3 → 2.16.5

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

@@ -107,10 +107,10 @@ export interface ExecutorContext {
     signal?: AbortSignal;
 }
 /**
- * Capabilities the HOST (openclaw gateway, or the qlogicagent CLI host) provides to back node
+ * Capabilities the HOST (xiaozhiclaw gateway, or the qlogicagent CLI host) provides to back node
  * kinds the engine cannot fulfil on its own. The engine stays a pure executor (plan D12/D13):
  * agent/tool/mcp/http are qlogicagent-owned host capabilities; channel/IM call back into the
- * openclaw channel layer. fail-loud: a host-backed kind with no host throws.
+ * xiaozhiclaw channel layer. fail-loud: a host-backed kind with no host throws.
  */
 export interface ExecutorHost {
     /** Run an agent turn. Returns the agent's structured output as DataItem(s). */
@@ -123,7 +123,7 @@ export interface ExecutorHost {
     httpRequest(req: HttpHostRequest): Promise<DataItem[]>;
     /** Invoke an MCP server tool. */
     invokeMcp(req: McpHostRequest): Promise<DataItem[]>;
-    /** Send a message out through a channel (飞书/微信/…) via the openclaw channel layer. */
+    /** Send a message out through a channel (飞书/微信/…) via the xiaozhiclaw channel layer. */
     sendChannel(req: ChannelHostRequest): Promise<DataItem[]>;
     /** Project-scoped memory (memdir) read/write/search for the `memory` kind (spec D25). */
     memory?(req: MemoryHostRequest): Promise<DataItem[]>;

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

@@ -3,7 +3,7 @@
  * with qlogicagent's actual capabilities. No mocks, no stubs (plan §1.5).
  *
  * Boundary capabilities (runAgent / invokeMcp / sendChannel) are injected so this file stays
- * decoupled from the handler host that owns processManager/acpDetector and the openclaw channel
+ * decoupled from the handler host that owns processManager/acpDetector and the xiaozhiclaw channel
  * callback. Tool invocation goes straight through the single-source-of-truth tool registry
  * (`findTool`). fail-loud everywhere: unknown tool, missing channel host, or any rejection throws.
  */
@@ -32,7 +32,7 @@ export interface QlaExecutorHostDeps {
         signal?: AbortSignal;
     }) => Promise<unknown>;
     /**
-     * Send a message out through a channel via the openclaw channel layer.
+     * Send a message out through a channel via the xiaozhiclaw channel layer.
      * Undefined in standalone qlogicagent (no gateway) → channel nodes fail-loud (D12/D13).
      */
     sendChannel?: (req: {

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

@@ -2,7 +2,7 @@
  * In-process workflow trigger scheduler (plan M3 trigger layer).
  *
  * Architecture note: scheduling lives INSIDE qlogicagent, not the gateway. This mirrors the
- * established precedent — the idle "dream" timer was deliberately moved out of the openclaw gateway
+ * established precedent — the idle "dream" timer was deliberately moved out of the xiaozhiclaw gateway
  * into qlogicagent so the Agent owns its own timed lifecycle ("Agent 是唯一状态拥有者"). The gateway
  * remains a pure relay: it terminates external ingress (webhook HTTP, inbound IM) and forwards those
  * events here via `onWebhook` / `onImMessage`; the cron clock and the run decision are the Agent's.

package/dist/types/protocol/methods.d.ts

@@ -170,8 +170,6 @@ export interface MemoryDreamResult {
 export interface ToolsListParams {
     /** Filter by category. */
     category?: ToolCapabilityCategory;
-    /** Include tools that are normally deferred until activated. */
-    includeDeferred?: boolean;
     /** Include tools that are installed but currently disabled by provider/config availability. */
     includeUnavailable?: boolean;
 }
@@ -186,7 +184,6 @@ export interface ToolsListResult {
         fallbackDescription: string;
         description: string;
         source: "builtin";
-        deferred: boolean;
         enabled?: boolean;
         parameters?: Record<string, unknown>;
     }>;

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

@@ -60,7 +60,7 @@ export interface AgentInstallSpec {
     /** Official docs / source URL (shown in the install confirmation). */
     docsUrl: string;
     /**
-     * Self/host-platform agents (e.g. openclaw) whose in-place UPDATE would disrupt the running session
+     * Self/host-platform agents (e.g. xiaozhiclaw) whose in-place UPDATE would disrupt the running session
      * (the engine bridges to a live instance). When already installed, the update runs DETACHED in the
      * background instead of as a child of the engine, and takes effect on the agent's next startup.
      */
@@ -421,6 +421,38 @@ export interface ProductReplayParams {
     productId: string;
     taskId: string;
 }
+/** x/goal.start RPC params — launch a long-horizon goal run (instant, returns goalRunId). */
+export interface GoalStartParams {
+    goal: string;
+    cwd?: string;
+    agentPool?: string[];
+    leaderAgentId?: string;
+}
+/** x/goal.status / x/goal.pause / x/goal.stop RPC params. */
+export interface GoalIdParams {
+    goalRunId: string;
+}
+/** x/goal.resume RPC params — optionally update the goal on resume. */
+export interface GoalResumeParams {
+    goalRunId: string;
+    newGoal?: string;
+}
+/** x/goal.updateGoal RPC params. */
+export interface GoalUpdateGoalParams {
+    goalRunId: string;
+    newGoal: string;
+}
+/** x/goal.message RPC params — queue a steering message for the next phase boundary. */
+export interface GoalMessageParams {
+    goalRunId: string;
+    text: string;
+}
+/** x/goal.events RPC params — page the event log from `fromSeq`. */
+export interface GoalEventsParams {
+    goalRunId: string;
+    fromSeq?: number;
+    limit?: number;
+}
 /** Runtime instance state. */
 export interface ProductInstanceStatus {
     instanceId: string;

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

@@ -41,6 +41,18 @@ export declare const ACP_EXTENDED_METHODS: {
     readonly WORKFLOW_CHAT: "x/workflow.chat";
     readonly WORKFLOW_MATCH_INTENT: "x/workflow.matchIntent";
     readonly PRODUCT_SUBSCRIBE: "x/product.subscribe";
+    readonly GOAL_START: "x/goal.start";
+    readonly GOAL_STATUS: "x/goal.status";
+    readonly GOAL_PAUSE: "x/goal.pause";
+    readonly GOAL_RESUME: "x/goal.resume";
+    readonly GOAL_UPDATE_GOAL: "x/goal.updateGoal";
+    readonly GOAL_STOP: "x/goal.stop";
+    readonly GOAL_MESSAGE: "x/goal.message";
+    readonly GOAL_SUBSCRIBE: "x/goal.subscribe";
+    readonly GOAL_EVENTS: "x/goal.events";
+    readonly MENTION_DELEGATE: "x/mention.delegate";
+    readonly MENTION_CANCEL: "x/mention.cancel";
+    readonly MENTION_LIST: "x/mention.list";
 };
 export type AcpExtendedMethod = (typeof ACP_EXTENDED_METHODS)[keyof typeof ACP_EXTENDED_METHODS];
 /** qlogicagent 专属扩展套件的协商开关(host 与 agent 双向声明)。存在即启用扩展。 */
@@ -56,7 +68,7 @@ export interface AcpQlogicagentCapability {
     /** Config options (agent side only). */
     configOptions?: AcpConfigOptionDescriptor[];
 }
-/** Host (openclaw / AionUI) capabilities declared at initialize. */
+/** Host (xiaozhiclaw / AionUI) capabilities declared at initialize. */
 export interface AcpHostCapabilities {
     /** Standard ACP (server does not consume this round; typed to match real hosts). */
     fs?: {
@@ -116,7 +128,7 @@ export interface AcpSessionMeta {
     temperature?: number;
     maxRounds?: number;
     /** Skills the user explicitly pinned for this turn (scope:name or name). The turn pipeline
-     *  force-loads each one's SKILL.md, identically to the `skill` tool's invoke (cc-parity). */
+     *  force-loads each one's SKILL.md, identically to the `skill_view` tool (cc-parity). */
     activeSkills?: string[];
 }
 export interface AcpSessionNewParams {
@@ -168,6 +180,9 @@ export interface AcpSessionPromptParams {
 export interface AcpSessionPromptResult {
     /** Stop reason (required by ACP standard). */
     stopReason: AcpStopReason;
+    /** Final assistant text for the turn (non-standard extension; emitted on end_turn). Lets the host
+     *  read the completed message alongside the streamed session/update chunks. */
+    content?: string;
     /** Token usage for this turn. */
     usage?: AcpUsage;
     /** Model that actually ran the turn (agent-resolved). Lets the host attribute

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

@@ -18,12 +18,12 @@ export declare const AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta",
  * Agent Team events (Solo Mode, Product Mode, Plan lifecycle).
  * Relayed to the UI's team/orchestration panel.
  */
-export declare const AGENT_TEAM_WS_EVENT_NAMES: readonly ["solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted"];
+export declare const AGENT_TEAM_WS_EVENT_NAMES: readonly ["solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated"];
 /**
  * All agent notifications that Gateway should relay to WS clients.
  * Union of session events + team events.
  */
-export declare const ALL_AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "memory.updated", "skills.updated", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted"];
+export declare const ALL_AGENT_WS_EVENT_NAMES: readonly ["turn.start", "turn.delta", "turn.end", "turn.error", "turn.recovery", "turn.tool_call", "turn.tool_result", "turn.tool_blocked", "turn.reasoning_delta", "turn.approval_request", "turn.skill_instruction", "turn.ask_user", "turn.media_result", "turn.media_progress", "turn.media_usage", "turn.media_capability_check", "turn.plan_update", "turn.suggestions", "turn.sidechain_started", "turn.subagent_started", "turn.subagent_delta", "turn.subagent_ended", "turn.sidechain_completed", "turn.task_updated", "turn.todos_updated", "turn.exec_progress", "turn.tool_use_summary", "turn.tool_selection_policy", "turn.lifecycle", "turn.document_maintenance", "turn.artifact_contract", "turn.usage_update", "team.member.notification", "session.info", "memory.updated", "skills.updated", "pet.soul_ready", "pet.reaction", "pet.growth", "pet.state", "pet.confirm", "pet.asset.updated", "system.activity", "workflow.created", "workflow.updated", "workflow.deleted", "workflow.runStarted", "workflow.runCompleted", "workflow.runFailed", "workflow.nodeStatus", "workflow.triggerDropped", "workflow.alert", "workflow.approvalRequested", "solo.progress", "solo.specProgress", "solo.agentDelta", "solo.agentActivity", "solo.agentUsage", "solo.evaluation", "product.taskStarted", "product.taskOutput", "product.members", "product.agentActivity", "product.taskCompleted", "product.taskFailed", "product.budgetUpdate", "product.budgetWarning", "product.checkpointed", "product.completed", "product.dagTopology", "plan.interrupted", "goal.run_state_changed", "goal.phase_boundary", "goal.goal_edited", "goal.message_queued", "goal.acceptance_updated"];
 /** Type-level event name for session events. */
 export type AgentWsEventName = (typeof AGENT_WS_EVENT_NAMES)[number];
 /** Type-level event name for team events. */

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

@@ -342,7 +342,6 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
     "tools.list": {
         params: {
             category?: ToolCapabilityCategory;
-            includeDeferred?: boolean;
         };
         result: {
             tools: Array<{
@@ -355,7 +354,6 @@ export interface AgentRpcMethodMap extends GatewayRpcMethodMap {
                 fallbackDescription: string;
                 description: string;
                 source: "builtin";
-                deferred: boolean;
                 parameters?: Record<string, unknown>;
             }>;
             total: number;

package/dist/types/protocol/wire/notification-payloads.d.ts

@@ -2,7 +2,7 @@
  * Agent Notification Payload Types — wire-format contract for all JSON-RPC notifications.
  *
  * These types define the exact shape of `params` in every notification the agent emits.
- * Consumers (openclaw UI, Hub relay, Electron, test harness) import from here
+ * Consumers (xiaozhiclaw UI, Hub relay, Electron, test harness) import from here
  * to get type-safe access to event payloads without depending on agent internals.
  *
  * Design: Agent's protocol/notifications.ts re-exports these; adding a new event =
@@ -279,7 +279,7 @@ export interface TurnToolUseSummaryNotification {
 export interface TurnToolSelectionPolicyNotification {
     turnId: string;
     policyId: string;
-    intent: "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "deferred_tool_discovery" | "tool_recovery" | "lifecycle_reconciliation";
+    intent: "benchmark_state_maintenance" | "fresh_evidence" | "verification" | "final_answer" | "tool_recovery" | "lifecycle_reconciliation";
     reason: string;
     availableToolNames: string[];
     enabledToolNamesBefore: string[];
@@ -795,22 +795,6 @@ export interface TaskUpdatedNotification {
     lifecycle: string;
     label?: string;
 }
-/** Team member state changed (idle/busy/error/exited). */
-export interface TeamMemberStateNotification {
-    memberId: string;
-    state: string;
-}
-/** Team created/destroyed. */
-export interface TeamUpdatedNotification {
-    teamName: string;
-    action: string;
-    members: Array<{
-        agentName: string;
-        role: string;
-        worktreePath?: string;
-        pid?: number;
-    }>;
-}
 /** Emitted when pet soul is hatched/ready. */
 export interface PetSoulReadyNotification {
     name: string;
@@ -929,6 +913,35 @@ export interface WorkflowRunFailedNotification {
     error: string;
     outcome?: unknown;
 }
+export interface GoalRunStateChangedNotification {
+    goalRunId: string;
+    status: "running" | "ended";
+    pauseState: "running" | "draining" | "paused";
+    endReason?: "done" | "stopped" | "failed";
+}
+export interface GoalPhaseBoundaryNotification {
+    goalRunId: string;
+    phaseIndex: number;
+    deltas: {
+        criterionId: string;
+        newStatus: string;
+    }[];
+    nextPreview?: string;
+    migrationNote?: string;
+}
+export interface GoalGoalEditedNotification {
+    goalRunId: string;
+    newVersion: number;
+}
+export interface GoalMessageQueuedNotification {
+    goalRunId: string;
+    queuedCount: number;
+}
+export interface GoalAcceptanceUpdatedNotification {
+    goalRunId: string;
+    criterionId: string;
+    status: string;
+}
 export interface NotificationMethodMap {
     "turn.start": TurnStartNotification;
     "turn.delta": TurnDeltaNotification;
@@ -973,8 +986,6 @@ export interface NotificationMethodMap {
     "session.info": SessionInfoNotification;
     "permission.rule_updated": PermissionRuleUpdatedNotification;
     "team.member.notification": TeamMemberNotification;
-    "team.member.state": TeamMemberStateNotification;
-    "team.updated": TeamUpdatedNotification;
     "turn.usage_update": TurnUsageUpdateNotification;
     "pong": PongNotification;
     "agents.status": AgentsStatusNotification;
@@ -1003,6 +1014,11 @@ export interface NotificationMethodMap {
     "product.planFailed": ProductPlanFailedNotification;
     "product.planningDelta": ProductPlanningDeltaNotification;
     "plan.interrupted": PlanInterruptedNotification;
+    "goal.run_state_changed": GoalRunStateChangedNotification;
+    "goal.phase_boundary": GoalPhaseBoundaryNotification;
+    "goal.goal_edited": GoalGoalEditedNotification;
+    "goal.message_queued": GoalMessageQueuedNotification;
+    "goal.acceptance_updated": GoalAcceptanceUpdatedNotification;
     "project.created": ProjectCreatedNotification;
     "project.switched": ProjectSwitchedNotification;
     "project.deleted": ProjectDeletedNotification;

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

@@ -1,30 +1,27 @@
 import type { CommunityConsentClient, CommunityPublishSkillResult } from "./community-consent-client.js";
-export interface CommunityPetPublishInput {
+/**
+ * Publish payload for a petdex pet: identity + safety-checked text, plus the prebuilt
+ * registry manifest and gzipped `.petdex` blob (built by buildPetdexPublishPayload in the
+ * pet module, so this stays free of pet packaging/IO knowledge).
+ */
+export interface PetAssetPublishInput {
     id: string;
     name: string;
-    summary: string;
-    persona: string;
-    traits?: string[];
-    assets?: Array<{
-        kind: string;
-        path: string;
-    }>;
+    description: string;
+    manifest: Record<string, unknown>;
+    version: string;
+    packageGzipBase64: string;
     visibility?: "public" | "private";
     tags?: string[];
 }
-export declare function packageCommunityPetAsset(input: CommunityPetPublishInput): {
-    manifest: {
-        schema_version: number;
-        kind: string;
-        name: string;
-        summary: string;
-        persona: string;
-        traits: string[];
-        assets: {
-            kind: string;
-            path: string;
-        }[];
-        tags: string[];
-    };
-};
-export declare function publishCommunityPetAsset(client: Pick<CommunityConsentClient, "getConsent" | "publishPet">, input: CommunityPetPublishInput): Promise<CommunityPublishSkillResult>;
+/**
+ * Pets are display-only sprite data, but their visible name/description still ship to the
+ * registry — keep the §11 safety gate: block private data leaks and any claim of agent powers.
+ */
+export declare function assertSafePetPublish(fields: {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+}): void;
+export declare function publishCommunityPetAsset(client: Pick<CommunityConsentClient, "getConsent" | "publishPet">, input: PetAssetPublishInput): Promise<CommunityPublishSkillResult>;

package/dist/types/runtime/community/community-signal-reporter.d.ts

@@ -11,23 +11,9 @@ export interface CommunitySkillLifecycleRecord {
     registryEffectiveRiskTier?: string;
     registryKeptSignalAt?: string;
 }
-export interface CommunitySkillLifecycleStore {
-    version?: number;
-    records: Record<string, CommunitySkillLifecycleRecord>;
-}
 export interface CommunitySignalReporter {
     record(input: CommunityRecordSignalInput): Promise<"recorded" | "disabled" | "skipped" | "failed">;
-    recordSkillUsage(record: CommunitySkillLifecycleRecord | undefined, outcome: CommunitySkillUsageOutcome): Promise<"recorded" | "disabled" | "skipped" | "failed">;
     recordSkillLifecycle(record: CommunitySkillLifecycleRecord | undefined, event: Extract<CommunitySignalEvent, "kept" | "uninstalled" | "endorse">): Promise<"recorded" | "disabled" | "skipped" | "failed">;
-    recordKeptSignals(store: CommunitySkillLifecycleStore, options?: RecordKeptSignalsOptions): Promise<Array<{
-        skillName: string;
-        status: "recorded" | "disabled" | "skipped" | "failed";
-    }>>;
-}
-export type CommunitySkillUsageOutcome = "success" | "fail" | "error" | "neutral";
-export interface RecordKeptSignalsOptions {
-    now?: Date;
-    retentionMs?: number;
 }
 export declare function createCommunitySignalReporter(client: Pick<CommunityConsentClient, "getConsent" | "recordSignal"> | null): CommunitySignalReporter;
 export declare function createDefaultCommunitySignalReporter(): CommunitySignalReporter | null;

package/dist/types/runtime/config/tunable-defaults.d.ts

@@ -78,10 +78,6 @@ export declare const REACTIVE_COMPACT_MAX_FAILURES = 3;
 export declare const REACTIVE_COMPACT_MIN_MESSAGES = 4;
 /** Target usage percentage for reactive compaction. */
 export declare const REACTIVE_COMPACT_TARGET_PERCENT = 50;
-/** Max auto-learned skills per project. */
-export declare const MAX_SKILLS_PER_PROJECT = 20;
-/** Max global (user-level) skills. */
-export declare const MAX_SKILLS_GLOBAL = 50;
 /** Min tool calls to consider a turn "complex enough" for skill creation. */
 export declare const MIN_TOOL_CALLS_FOR_SKILL = 3;
 /** Min distinct tools to suggest a new skill. */
@@ -100,16 +96,6 @@ export declare const SKILL_PATTERN_REPETITION_THRESHOLD = 3;
  * Default: 30 days.
  */
 export declare const SKILL_PATTERN_MAX_AGE_MS: number;
-/** Max chars of skill content injected into system prompt. */
-export declare const SKILL_INJECTION_MAX_CHARS = 4000;
-/** Max skills injected into a single prompt. */
-export declare const SKILL_INJECTION_MAX_COUNT = 5;
-/** Max skills recalled from other projects per turn. */
-export declare const SKILL_RECALL_MAX_SKILLS = 3;
-/** Max chars per recalled skill content. */
-export declare const SKILL_RECALL_MAX_CONTENT_CHARS = 800;
-/** Skill recall index cache TTL (ms). */
-export declare const SKILL_RECALL_CACHE_TTL_MS: number;
 /** Max nested fork depth for sub-agents. */
 export declare const MAX_FORK_DEPTH = 4;
 /** Team aggregate budget (total tokens across all forked sub-agents). 0 = unlimited. */
@@ -206,16 +192,9 @@ export interface TunableDefaults {
     reactiveCompactMaxFailures: number;
     reactiveCompactMinMessages: number;
     reactiveCompactTargetPercent: number;
-    maxSkillsPerProject: number;
-    maxSkillsGlobal: number;
     minToolCallsForSkill: number;
     minDistinctToolsForSkill: number;
     skillCreationCooldownMs: number;
-    skillInjectionMaxChars: number;
-    skillInjectionMaxCount: number;
-    skillRecallMaxSkills: number;
-    skillRecallMaxContentChars: number;
-    skillRecallCacheTtlMs: number;
     maxForkDepth: number;
     maxSessions: number;
     taskSummaryTurnThreshold: number;

package/dist/types/runtime/hooks/community-discovery-hook.d.ts

@@ -0,0 +1,18 @@
+import type { HookRegistry } from "../../contracts/hooks.js";
+import type { CommunityDiscoveryCoordinator } from "../community/community-discovery-coordinator.js";
+export interface CommunityDiscoveryHookDeps {
+    /** Online community discovery coordinator (null disables discovery). */
+    communityDiscovery?: CommunityDiscoveryCoordinator | null;
+    /** Logger. */
+    log: {
+        debug(msg: string): void;
+        warn(msg: string): void;
+    };
+}
+/**
+ * Register the community-discovery hook on `memory.before_recall`.
+ * Runs at lower priority (60) than QMemory prefetch (50) so it supplements,
+ * not replaces, the standard memory recall. When a Hub resource matches the
+ * turn, its metadata is injected into recalledMemories as a suggestion.
+ */
+export declare function registerCommunityDiscoveryHook(hooks: HookRegistry, deps: CommunityDiscoveryHookDeps): () => void;

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

@@ -1,7 +1,7 @@
 /**
  * ACP Protocol Adapter — a thin wrapper over the official @agentclientprotocol/sdk
  * `ClientSideConnection`. qlogicagent is the ACP *client* (host); spawned external
- * agents (codex-acp, claude-agent-acp, openclaw, …) are the ACP *agents*.
+ * agents (codex-acp, claude-agent-acp, xiaozhiclaw, …) are the ACP *agents*.
  *
  * The SDK owns the wire protocol entirely: JSON-RPC 2.0 / NDJSON framing, request↔response
  * correlation, and the reverse-RPC dispatch. This module owns only the three concerns the SDK
@@ -11,7 +11,7 @@
  *   3. translating SDK `session/update` notifications into qlogicagent's internal `turn.*` methods
  *
  * Extension capabilities (clientCapabilities.qlogicagent) are forwarded verbatim — the SDK does
- * not strip outgoing params (validation runs only on the receiving side), so openclaw interop is
+ * not strip outgoing params (validation runs only on the receiving side), so xiaozhiclaw interop is
  * preserved.
  */
 import type { ChildProcess } from "node:child_process";

package/dist/types/runtime/infra/agent-install-runner.d.ts

@@ -67,7 +67,7 @@ export declare function launchSetupTerminal(command: string, platform?: NodeJS.P
 };
 /**
  * Fire-and-forget install in a FULLY DETACHED process (own session/process-group, no stdio shared with
- * us). Used for self/host-platform agents (openclaw) whose in-place UPDATE would otherwise disrupt the
+ * us). Used for self/host-platform agents (xiaozhiclaw) whose in-place UPDATE would otherwise disrupt the
  * running engine the install is a child of — "Agent process stdio closed". Returns immediately; the new
  * version is live on the agent's next startup. No progress streaming (the process is detached).
  */

package/dist/types/runtime/infra/llmrouter-catalog.d.ts

@@ -9,6 +9,16 @@ interface CatalogFetchOptions {
 export declare class LlmrouterCatalogUnavailableError extends Error {
     constructor(message?: string);
 }
+/**
+ * Raised when the llmrouter published endpoint (/v1/models) rejects the inference key with an
+ * auth failure (401/403). This is a PERSISTENT condition (revoked/expired/inactive key), unlike a
+ * transient network blip — so callers must NOT fall back to the full routable catalog (that would
+ * advertise 600+ models the dead key cannot actually call). Surface "please re-authenticate" instead.
+ */
+export declare class LlmrouterAuthError extends Error {
+    readonly status: number;
+    constructor(status: number, message?: string);
+}
 export interface LlmrouterCatalogProvider {
     id: string;
     name?: string;

package/dist/types/runtime/infra/skill-resolver.d.ts

@@ -36,7 +36,7 @@ export declare function isSystemGeneratedSkillName(name: string): boolean;
  * callers that only want active skills filter `.active` (or use resolveActiveSkills).
  */
 export declare function resolveSkills(projectRoot?: string): ResolvedSkill[];
-/** Only the skills active in the given project (for prompt injection / resolution). */
+/** Only the skills active in the given project (for the system-prompt skills catalog / resolution). */
 export declare function resolveActiveSkills(projectRoot?: string): ResolvedSkill[];
 /**
  * Resolve a single skill by name to its store paths, or null if not present.

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

@@ -1,26 +1,31 @@
 import type { CommunityInstallResolution } from "../community/community-consent-client.js";
-export interface InstalledCommunityPetResource {
+import { type PetdexPetAssetSummary } from "./petdex-asset.js";
+export interface InstalledCommunityPet {
     kind: "pet";
     status: "installed";
     resourceId: string;
     version: string;
     checksum: string;
-    installDir: string;
+    /** Petdex asset id now registered in profile.customPets. */
+    assetId: string;
     name: string;
-    sanitized: boolean;
-    /** Number of declared asset files materialized to disk. */
-    assetCount: number;
+    /** Materialized petdex summary (atlas imageUrl = spritesheet data URL) for instant UI hydration. */
+    asset: PetdexPetAssetSummary;
 }
 export interface InstallCommunityPetOptions {
     fetchFn?: typeof fetch;
-    /** Replace an existing install in place (update flow) instead of erroring. */
+    /** 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 (WS-AD4): download the asset package,
- * verify the whole-package sha256 (+ per-file sha256 when declared), unpack to a
- * quarantine dir, then land it atomically at the install dir. Previously this only
- * wrote manifest.json — the actual webp/animation bytes never reached disk.
+ * 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<InstalledCommunityPetResource>;
+export declare function installCommunityPetResource(install: CommunityInstallResolution, options?: InstallCommunityPetOptions): Promise<InstalledCommunityPet>;
 export declare function assertPetInstall(install: CommunityInstallResolution): void;

package/dist/types/runtime/pet/pet-profile-service.d.ts

@@ -7,7 +7,7 @@ export interface PetPreferences {
 export interface PetdexPetAssetSummary {
     id: string;
     assetKind: "petdex";
-    sourceKind?: "builtin" | "upload" | "forge";
+    sourceKind?: "builtin" | "upload" | "forge" | "community";
     name: string;
     description: string;
     createdAt: string;
@@ -38,7 +38,7 @@ export interface PetdexPetAsset extends Omit<PetdexPetAssetSummary, "atlas"> {
     schema: "qlogic.petdex.asset.v1";
     atlas: PetdexPetAssetAtlas;
     source: {
-        kind: "builtin" | "upload" | "forge";
+        kind: "builtin" | "upload" | "forge" | "community";
         prompt: string | null;
     };
     animations: Record<PetdexAnimationId, PetdexPetAnimation>;

package/dist/types/runtime/pet/petdex-asset.d.ts

@@ -2,6 +2,8 @@ import { type PetdexAssetSource, type PetdexPetAsset, type PetdexValidationRepor
 export { PETDEX_SCHEMA, PETDEX_VALIDATION_SCHEMA, PETDEX_ATLAS_CONTRACT, PETDEX_ANIMATION_IDS, createDefaultPetdexAnimations, toPetdexAssetSummary, validatePetdexAssetManifest, petdexImageDataUrl, } from "@xiaozhiclaw/pet-core";
 export type { PetdexAnimationId, PetdexAnimation, PetdexAtlas, PetdexAssetSource, PetdexPetAsset, PetdexAssetManifest, PetdexPetAssetSummary, PetdexValidationReport, LoadedPetdexPackage, PetdexAssetPackage, PetdexAssetValidation, PetdexImportResult, } from "@xiaozhiclaw/pet-core";
 export declare function loadPetdexAssetPackage(filePath: string): Promise<LoadedPetdexPackage>;
+/** Load a `.petdex` package directly from its zip bytes (community install downloads it). */
+export declare function loadPetdexAssetPackageBytes(zip: Buffer): Promise<LoadedPetdexPackage>;
 export declare function buildPetdexAssetImport(filePath: string, targetDir: string): Promise<PetdexImportResult>;
 export declare function writePetdexAssetPackage(params: {
     asset: PetdexPetAsset;
@@ -11,6 +13,32 @@ export declare function writePetdexAssetPackage(params: {
     outputDir: string;
     fileName?: string;
 }): Promise<string>;
+/**
+ * Build a `.petdex` zip in memory (single source of truth for the package layout).
+ * Community publish gzips these bytes for Hub OSS; writePetdexAssetPackage lands them on disk.
+ * Validation is recomputed from asset+spritesheet so the embedded validation.json always matches.
+ */
+export declare function buildPetdexAssetPackageBytes(params: {
+    asset: PetdexPetAsset;
+    spritesheet: Buffer;
+    productionRun?: unknown;
+}): Buffer;
+/**
+ * Package a petdex asset for community publish: the gzipped `.petdex` blob (the exact wire
+ * format Hub OSS serves at downloadUrl, which the installer gunzips) plus a v15 asset manifest
+ * carrying the petdex asset descriptor. The hub derives checksum + sizeBytes from the decoded
+ * blob server-side, so neither is sent here.
+ */
+export declare function buildPetdexPublishPayload(params: {
+    asset: PetdexPetAsset;
+    spritesheet: Buffer;
+    version?: string;
+    tags?: string[];
+}): {
+    manifest: Record<string, unknown>;
+    version: string;
+    packageGzipBase64: string;
+};
 export declare function createPetdexAssetFromSpritesheet(params: {
     id?: string;
     name: string;

package/dist/types/runtime/ports/tool-contracts.d.ts

@@ -26,7 +26,6 @@ export interface RuntimeToolContract {
     isEgress?: boolean;
     egressCarriesData?: boolean;
     isEnabled?: () => boolean;
-    shouldDefer?: boolean;
     execute?(toolCallId: string, params: any, signal?: AbortSignal): Promise<{
         content: Array<{
             type: "text" | "image";
@@ -40,20 +39,12 @@ export interface RuntimeToolContract {
 }
 export interface ToolCatalog {
     findTool(name: string): RuntimeToolContract | undefined;
-    getToolManifest(includeDeferred?: boolean): ToolDefinition[];
+    getToolManifest(): ToolDefinition[];
     getToolNames(): string[];
     setTools(tools: RuntimeToolContract[]): void;
     addTool(tool: RuntimeToolContract): void;
     addTools(tools: RuntimeToolContract[]): void;
     removeTool(name: string): boolean;
-    activateTool(name: string): boolean;
-    clearActivatedTools(): void;
-    /** SSOT for the deferred-tool set consumed by the prompt index and the tool_search corpus. */
-    listDeferredTools(): Array<{
-        name: string;
-        description: string;
-        searchHint?: string;
-    }>;
 }
 export interface ToolBootstrapProgress {
     output: string;