qlogicagent 2.13.7 → 2.13.8

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

@@ -0,0 +1,9 @@
+import type { PortableTool } from "../skills/portable-tool.js";
+import { type CommunityDiscoveryResult } from "../runtime/community/community-discovery-coordinator.js";
+export interface LocalCommunityToolRegistrationContext {
+    tools: PortableTool<any>[];
+    /** 测试可注入的发现实现;默认从 env consent client 构造协调器。 */
+    discover?: (intent: string) => Promise<CommunityDiscoveryResult>;
+}
+export declare const localCommunityToolRegistrationModule: import("../runtime/ports/tool-contracts.js").ToolRegistrationModule<LocalCommunityToolRegistrationContext>;
+export declare function registerLocalCommunityTools(context: LocalCommunityToolRegistrationContext): void;

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

@@ -0,0 +1,77 @@
+/**
+ * Node params schema — single source for "what params does each node kind take" (spec R6 / D45).
+ *
+ * Two schema sources, one resolver:
+ *   - tool / mcp  → per-capability `paramsSchema` on the CapabilityEntry (the tool's own arg schema,
+ *     validates node.params.args).
+ *   - everything else (http/agent/channel/memory/if/filter/switch/transform/wait/...) → a per-KIND
+ *     schema here (KIND_PARAM_SCHEMAS), validates node.params directly.
+ *
+ * The schemas are a JSON-Schema subset aligned with the canvas SchemaArgsForm consumer
+ * (type/enum/default/minimum/maximum/multipleOf/format/x-widget). `required` mirrors what the REAL
+ * executors throw on (host-executors.ts / builtin-executors.ts) — not a wishlist.
+ *
+ * fail-loud posture: `validateParamsAgainstSchema` flags missing-required / wrong-enum / wrong-type
+ * so the AI generation gate (AI-2) can reject and self-correct. Two deliberate exemptions:
+ *   - a value that is a `{{ }}` template is skipped for type checks (resolved at runtime).
+ *   - an `__ASK__: 问题` sentinel (brace-less ON PURPOSE so it bypasses the {{ }} expression gate in
+ *     validateDefExpressions) counts as "present but pending" (the agent honestly marking an unknown,
+ *     not a hallucination) — surfaced by collectClarifications for the 待补 badge + activation gate.
+ */
+import type { CapabilityEntry } from "./capability-catalog.js";
+/** Per-kind params schemas for non tool/mcp kinds. `trigger` (workflow-level trigger def) and
+ *  `manual` (n8n import placeholder that always fails) are intentionally excluded. */
+export declare const KIND_PARAM_SCHEMAS: Record<string, Record<string, unknown>>;
+/** An `__ASK__: 问题` sentinel — the agent honestly marking an unknown required value (AI-2).
+ *  Brace-less by design so it doesn't enter the {{ }} restricted-expression gate. */
+export declare function isAskPlaceholder(v: unknown): boolean;
+type NodeLike = {
+    id: string;
+    kind: string;
+    params?: Record<string, unknown>;
+};
+/**
+ * The schema that governs a node's params:
+ *   - tool → the tool capability's paramsSchema (governs params.args).
+ *   - mcp  → the "server.tool" capability's paramsSchema (governs params.args).
+ *   - else → KIND_PARAM_SCHEMAS[kind] (governs params directly).
+ * Returns undefined when no schema is known (e.g. a tool ref outside the catalog).
+ */
+export declare function resolveNodeParamsSchema(node: NodeLike, entries: CapabilityEntry[]): Record<string, unknown> | undefined;
+/**
+ * Validate every node's params against its resolved schema. Returns human-readable Chinese errors
+ * (empty = clean). Skips `trigger` (trigger def is validated elsewhere) and `manual` (placeholder).
+ * Unknown kinds with no schema are skipped here (validateCapabilityRefs / validateGraph cover refs).
+ */
+export declare function validateParamsAgainstSchema(def: {
+    nodes: NodeLike[];
+}, entries: CapabilityEntry[]): string[];
+/**
+ * Collect every `{{ __ASK__ }}` placeholder in a def (top-level params + one level into `args`).
+ * Drives the canvas "待补" badge and the activation gate (a workflow with pending asks cannot be
+ * activated). Empty = nothing pending.
+ */
+export declare function collectAskPlaceholders(def: {
+    nodes: NodeLike[];
+}): {
+    nodeId: string;
+    field: string;
+}[];
+/**
+ * Like collectAskPlaceholders but carries the question text — drives the workflow.chat `clarify`
+ * bubble (AI-2). Empty = nothing to ask.
+ */
+export declare function collectClarifications(def: {
+    nodes: NodeLike[];
+}): {
+    nodeId: string;
+    field: string;
+    question: string;
+}[];
+/**
+ * Compact per-kind params hint for the AI graph-builder prompt, derived from KIND_PARAM_SCHEMAS
+ * (single source — the prompt never hand-duplicates param names). tool/mcp carry per-capability
+ * arg schemas (the agent reads them via list_capabilities), so they get a pointer not a field list.
+ */
+export declare function renderKindParamsForPrompt(): string;
+export {};

package/dist/types/orchestration/workflow/run-history-store.d.ts

@@ -19,6 +19,7 @@
  * must never block a run).
  */
 import type { RunResult } from "./workflow-runtime.js";
+import { type WorkflowError } from "./workflow-error.js";
 export declare const MAX_RUN_HISTORY = 20;
 export type RunHistoryStatus = "running" | "completed" | "failed" | "paused" | "skipped" | "canceled";
 export interface RunNodeRecord {
@@ -42,6 +43,11 @@ export interface RunHistoryEntry {
     finishedAt?: string;
     durationMs?: number;
     error?: string;
+    /** AI-5 (D49): classified, human-readable form of `error` (人话 + class + 0-死端 next-step actions). */
+    errorInfo?: WorkflowError;
+    /** AI-5: node that caused a "failed" run — precise canvas attribution. Hard-stop failures reject
+     *  without node records, so the runtime tags the failing node onto the thrown error. */
+    failedNodeId?: string;
     /** nodeId → output record. Present once the run settles (not while running). */
     nodes?: Record<string, RunNodeRecord>;
 }
@@ -55,7 +61,7 @@ export declare class WorkflowRunHistoryStore {
     /** Record a run start. Prepends a "running" entry and prunes to the bound. */
     begin(workflowId: string, entry: Pick<RunHistoryEntry, "runId" | "triggerType" | "startedAt">): Promise<void>;
     /** Settle a run entry (status/outputs/error). Unknown runId is a no-op (pruned entry). */
-    finish(workflowId: string, runId: string, patch: Partial<Pick<RunHistoryEntry, "status" | "finishedAt" | "durationMs" | "error" | "nodes">>): Promise<void>;
+    finish(workflowId: string, runId: string, patch: Partial<Pick<RunHistoryEntry, "status" | "finishedAt" | "durationMs" | "error" | "failedNodeId" | "nodes">>): Promise<void>;
     /** Most-recent-first run summaries (no node outputs — those stay behind get()). */
     list(workflowId: string): Promise<RunHistorySummary[]>;
     /** Full entry incl. per-node output previews. */

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

@@ -0,0 +1,28 @@
+/**
+ * Workflow run-error classification (spec R6 / D49 / AI-5).
+ *
+ * Turns a raw thrown Error message into a human-readable, classified WorkflowError so the canvas can
+ * show 人话 (never a stack) + the right next-step buttons (0 死端). Pure & deterministic — unit
+ * tested. The executors throw plain Error(message); this maps those messages to a class + 中文说明.
+ */
+export type WorkflowErrorClass = "user" | "capability" | "network" | "system";
+/** Next-step buttons the canvas offers for an error (0 死端 — every failure has a way forward). */
+export type WorkflowErrorAction = "ai_fix" | "rerun_node" | "rerun_all" | "open_credentials" | "swap_capability";
+export interface WorkflowError {
+    class: WorkflowErrorClass;
+    /** Plain-language Chinese explanation (NO stack trace). */
+    message: string;
+    /** What to do about it, in one line. */
+    hint?: string;
+    /** Ordered next-step actions for the UI (first = primary). */
+    actions: WorkflowErrorAction[];
+    /** Truncated raw message, for the advanced/debug view only. */
+    detail?: string;
+}
+/**
+ * Classify a node failure. `raw` is the thrown error's message; `opts.nodeKind` refines wording.
+ * Order matters: credential/auth and capability checks run before the generic "param" check.
+ */
+export declare function classifyWorkflowError(raw: string, opts?: {
+    nodeKind?: string;
+}): WorkflowError;

package/dist/types/orchestration/workflow-chat-builder.d.ts

@@ -50,6 +50,16 @@ export interface WorkflowChatResult {
         attempts: number;
         errors: string[];
     };
+    /**
+     * AI-2: per-field {{ __ASK__ }} placeholders the agent left for genuinely-unknown REQUIRED values.
+     * The def IS applied (so the user sees the shape) but these nodes show a 待补 badge and the
+     * workflow cannot be activated until resolved. Absent/empty = nothing pending.
+     */
+    clarify?: {
+        nodeId: string;
+        field: string;
+        question: string;
+    }[];
 }
 /** agent 按需检索能力长尾(系统提示只放每类前 N 条)。 */
 export declare const LIST_CAPABILITIES_TOOL_NAME = "list_capabilities";

package/dist/types/runtime/community/activity-event-emitter.d.ts

@@ -0,0 +1,24 @@
+import { type ActivityEvent, type CreateActivityEventInput } from "./activity-event.js";
+import { type CommunityConsentClient } from "./community-consent-client.js";
+export type ActivityEmitStatus = "emitted" | "disabled" | "consent-blocked" | "failed";
+/** 活动事件出口:真实实现把事件写入 community-service(社交通道,非权威)。 */
+export interface ActivityEventTransport {
+    emit(event: ActivityEvent): Promise<void>;
+}
+export interface ActivityEventEmitterDeps {
+    /** 无 transport(未配置 / dev)→ "disabled"。 */
+    transport: ActivityEventTransport | null;
+    /** consent 源;community 事件必须能验 consent,否则 fail-safe 拦下。 */
+    consent: Pick<CommunityConsentClient, "getConsent"> | null;
+}
+export interface ActivityEventEmitter {
+    emit(input: CreateActivityEventInput): Promise<ActivityEmitStatus>;
+}
+export declare function createActivityEventEmitter(deps: ActivityEventEmitterDeps): ActivityEventEmitter;
+/** 把 community-service 的 emitActivity 包成 transport(社交写只走此通道,零触碰权威)。 */
+export declare function createHubActivityTransport(client: Pick<CommunityConsentClient, "emitActivity">): ActivityEventTransport;
+/**
+ * 默认发射器:从 env consent client 构造 transport + consent。
+ * 无 token(dev)→ client null → transport null(emit 返回 "disabled",fail-safe)。
+ */
+export declare function createDefaultActivityEventEmitter(): ActivityEventEmitter;

package/dist/types/runtime/community/activity-event.d.ts

@@ -0,0 +1,60 @@
+export type TrustSignalEventType = "installed" | "success" | "fail" | "error" | "kept" | "uninstalled" | "endorse";
+export type ExperientialEventType = "acquire" | "ask" | "answer" | "encounter" | "review";
+export type FlauntEventType = "unlock" | "flaunt";
+export type ActivityEventType = TrustSignalEventType | ExperientialEventType | FlauntEventType;
+/**
+ * 空间锚点:agent 发射时本就持有 resourceId 与其 category,事件自带锚点让集市
+ * 端零反查地把微动画钉到正确街区 / 店铺。**只允许 districtId / shopId。**
+ */
+export interface ActivitySpatialAnchor {
+    /** RESOURCE_CATEGORIES 的 category key(23 类稳定 key)。 */
+    districtId?: string;
+    /** canonical resourceId(店铺稳定主键)。 */
+    shopId?: string;
+}
+/** 禁止出现在 anchor 上的权威坐标键(DR12 红线,防后人误加诱导 v2 位置漂移)。 */
+export declare const FORBIDDEN_ANCHOR_KEYS: readonly string[];
+export interface ActivityPayload {
+    /** 空间归属锚点(可选);禁权威坐标。 */
+    anchor?: ActivitySpatialAnchor;
+    [k: string]: unknown;
+}
+export type ActivityVisibility = "owner" | "community";
+export interface ActivityEvent {
+    /** 幂等键。 */
+    id: string;
+    type: ActivityEventType;
+    /** 逐事件时间戳(epoch ms)。 */
+    ts: number;
+    /** 行动者 = 本人宠物人格(community-service 持有)。 */
+    actorPetId: string;
+    /** 对端 actorPetId(社交事件;离场降级"最近一次在场",不承诺在线;OFF 时缺省)。 */
+    peerRef?: string;
+    /** 已过脱敏边界(DR3);anchor 禁权威坐标。 */
+    payload: ActivityPayload;
+    /** owner=只进自己偷窥窗;community=游历 ON 才有(默认 owner,fail-safe)。 */
+    visibility: ActivityVisibility;
+}
+export declare function isTrustSignalEvent(type: ActivityEventType): type is TrustSignalEventType;
+export declare function isExperientialEvent(type: ActivityEventType): type is ExperientialEventType;
+export declare function isFlauntEvent(type: ActivityEventType): type is FlauntEventType;
+export declare function isActivityEventType(value: unknown): value is ActivityEventType;
+export interface CreateActivityEventInput {
+    id: string;
+    type: ActivityEventType;
+    ts: number;
+    actorPetId: string;
+    peerRef?: string;
+    payload?: ActivityPayload;
+    /** 默认 "owner"(fail-safe:跨租户可见须显式 + 上游 consent/roaming 闸放行)。 */
+    visibility?: ActivityVisibility;
+}
+/**
+ * 校验 anchor:只保留 districtId / shopId;若出现任何权威坐标键 → 抛错(DR12 红线,
+ * 纵深防御:契约层就拦,不靠调用方自觉)。
+ */
+export declare function sanitizeAnchor(anchor: ActivitySpatialAnchor | undefined): ActivitySpatialAnchor | undefined;
+/**
+ * 构造一个经校验的 ActivityEvent。校验必填字段、规范化 anchor、默认 visibility=owner。
+ */
+export declare function createActivityEvent(input: CreateActivityEventInput): ActivityEvent;

package/dist/types/runtime/community/autonomy-budget.d.ts

@@ -0,0 +1,26 @@
+export type AcquisitionRiskTier = "R0" | "R1" | "R2" | "R3";
+export type AcquisitionSourceTier = "official" | "community";
+export type AcquisitionMode = "silent" | "ask" | "high-risk-ask";
+export interface AutonomyBudgetConfig {
+    /** 自治预算总开关。默认 ON(DR6);OFF → 一律问人。 */
+    enabled: boolean;
+}
+/** 默认配置:开箱即默认开(DR6 安装自治默认 ON;仅管本地取 R0/低风险 inert)。 */
+export declare const DEFAULT_AUTONOMY_BUDGET: AutonomyBudgetConfig;
+export interface AcquisitionContext {
+    effectiveRiskTier: AcquisitionRiskTier;
+    sourceTier: AcquisitionSourceTier;
+}
+export interface AcquisitionDecision {
+    mode: AcquisitionMode;
+    /** 是否需要 explicitInstallConsent(R>0 的普通问人)。 */
+    requiresInstallConsent: boolean;
+    /** 是否需要 explicitHighRiskConsent(R2/R3)。 */
+    requiresHighRiskConsent: boolean;
+    reason: string;
+}
+/**
+ * 决定一次资源获取走静默 / 问人 / 高危问人。纯函数,无副作用。
+ * 高危(R2/R3)优先级最高:无论预算开关,都必须高危问人(可执行高危永不自动)。
+ */
+export declare function decideAcquisition(ctx: AcquisitionContext, config?: AutonomyBudgetConfig): AcquisitionDecision;

package/dist/types/runtime/community/community-consent-client.d.ts

@@ -1,4 +1,5 @@
 import type { ConfigPort } from "../ports/index.js";
+import type { ActivityEvent } from "./activity-event.js";
 import type { CommunityTelemetryEvent } from "./community-telemetry-types.js";
 export interface CommunityConsentView {
     enabled: boolean;
@@ -37,6 +38,16 @@ export interface CommunityConsentClient {
     listComments?(resourceId: string): Promise<CommunityComment[]>;
     /** Post a community comment (WS-B4); new accounts are folded by the Hub. Optional for mocks. */
     postComment?(resourceId: string, body: string): Promise<CommunityCommentPosted>;
+    /** Cut2: emit one ActivityEvent to community-service (social channel, non-authoritative). Optional for mocks. */
+    emitActivity?(event: ActivityEvent): Promise<void>;
+    /** Cut4: author an agent review for a resource (social channel). Optional for mocks. */
+    recordCommunityReview?(input: CommunityReviewInput): Promise<void>;
+    /** Cut4: post a help request to the community (social channel). Optional for mocks. */
+    recordCommunityAsk?(input: CommunityAskInput): Promise<void>;
+    /** Cut4: answer a peer's help request (social channel). Optional for mocks. */
+    recordCommunityAnswer?(input: CommunityAnswerInput): Promise<void>;
+    /** Cut5: record a pet-to-pet interaction (gated by roaming/gateSocialEvent first). Optional for mocks. */
+    recordCommunityInteraction?(input: CommunityInteractionInput): Promise<void>;
     /** Resolve a vetted runtime binary (e.g. officecli) for this platform → Hub-signed download. */
     resolveRuntime(id: string, platform: string): Promise<CommunityRuntimeResolution>;
     listSharedResources(): Promise<CommunitySharedResource[]>;
@@ -112,6 +123,42 @@ export interface CommunityRecordSignalInput {
 export interface CommunityRecordSignalResult {
     accepted: true;
 }
+/** Cut4:agent 撰写的评价(经历 + 结果 + 场景)。experience 须已过 soul.ts 脱敏(R24)。 */
+export interface CommunityReviewInput {
+    id: string;
+    resourceId: string;
+    /** 不可逆 petKey(derivePetKey)。 */
+    actorPetId: string;
+    experience: string;
+    outcome: "success" | "fail" | "neutral";
+    contextCategory?: string;
+    ts: number;
+}
+/** Cut4 求助频道:agent 发求助帖。question 须已脱敏(R24)。 */
+export interface CommunityAskInput {
+    id: string;
+    askerPetId: string;
+    question: string;
+    contextCategory?: string;
+    ts: number;
+}
+/** Cut4 求助频道:对端 agent 应答。answer 须已脱敏(R24)。 */
+export interface CommunityAnswerInput {
+    id: string;
+    askId: string;
+    answererPetId: string;
+    answer: string;
+    ts: number;
+}
+/** Cut5 宠物互动:greet/share/mention。须已过 gateSocialEvent 游历门控放行。 */
+export interface CommunityInteractionInput {
+    id: string;
+    kind: "greet" | "share" | "mention";
+    actorPetId: string;
+    peerPetId: string;
+    payload?: Record<string, unknown>;
+    ts: number;
+}
 export interface CommunityRecordTelemetryInput {
     event: CommunityTelemetryEvent;
     metadata?: Record<string, unknown>;

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

@@ -0,0 +1,7 @@
+/**
+ * 由 (ownerUserId, deviceId) 派生不可逆 petKey。sha256 截断;owner/device 原文绝不出现在结果里。
+ * 用 NUL(charCode 0)分隔,避免 ("a b","c") 与 ("a","b c") 撞键(owner/device 不含 NUL)。
+ */
+export declare function derivePetKey(ownerUserId: string, deviceId: string): string;
+/** 是否是合法 petKey 形状(pk_ + 24 位 hex)。 */
+export declare function isPetKey(value: unknown): value is string;

package/dist/types/runtime/community/roaming-gate.d.ts

@@ -0,0 +1,19 @@
+export type CarryOutLevel = "capability-meta" | "sanitized-story";
+export type CarryOutVisibility = "owner" | "community";
+export interface RoamingContext {
+    /** 设置-宠物「外出游历」总闸(DR2,默认 OFF / 首启知情 opt-in)。 */
+    roamingEnabled: boolean;
+    /** 本次带出物是否含高敏感内容(由调用方的敏感度判定给出)。 */
+    highSensitivity: boolean;
+}
+export interface CarryOutDecision {
+    level: CarryOutLevel;
+    visibility: CarryOutVisibility;
+    /** 高敏感 → 自动升级问人一次(DR3),不静默外发。 */
+    escalateToAsk: boolean;
+    reason: string;
+}
+/**
+ * 决定带出级别 / 可见性 / 是否升级。纯函数,无副作用。优先级:高敏感 > 游历闸。
+ */
+export declare function decideCarryOut(ctx: RoamingContext): CarryOutDecision;

package/dist/types/runtime/community/social-emission.d.ts

@@ -0,0 +1,16 @@
+import { type RoamingContext } from "./roaming-gate.js";
+import type { CarryOutLevel } from "./roaming-gate.js";
+import type { CreateActivityEventInput } from "./activity-event.js";
+export type SocialEmissionAction = "emit-community" | "owner-only" | "escalate";
+export interface GatedSocialEvent {
+    action: SocialEmissionAction;
+    /** 已按 DR2/DR3 设好 visibility 的事件(escalate / owner-only 时 visibility=owner)。 */
+    event: CreateActivityEventInput;
+    carryOutLevel: CarryOutLevel;
+    reason: string;
+}
+/**
+ * 过游历闸决定一条社交事件的最终归宿。纯函数,不发射。
+ * 调用方:escalate → 升级问用户;emit-community / owner-only → 交 emitter.emit(gated.event)。
+ */
+export declare function gateSocialEvent(base: CreateActivityEventInput, ctx: RoamingContext): GatedSocialEvent;

package/dist/types/skills/tools/community-seek-tool.d.ts

@@ -0,0 +1,73 @@
+import type { PortableTool } from "../portable-tool.js";
+import type { CommunityDiscoveryResult, CommunityDiscoveryStatus } from "../../runtime/community/community-discovery-coordinator.js";
+import type { CommunityInstallRiskTier, CommunityInstallSourceTier, CommunityInstallTrustStage, CommunityRegistryMatchResult } from "../../runtime/community/community-consent-client.js";
+export declare const COMMUNITY_SEEK_TOOL_NAME: "community_seek";
+export type CommunitySeekKind = "package" | "answer";
+export interface CommunitySeekParams {
+    intent: string;
+    kinds?: CommunitySeekKind[];
+}
+export interface CommunitySeekPackageCandidate {
+    kind: "package";
+    id: string;
+    title: string;
+    summary: string;
+    capabilityTags: string[];
+    sourceTier: CommunityInstallSourceTier;
+    trustStage: CommunityInstallTrustStage;
+    effectiveRiskTier: CommunityInstallRiskTier;
+    latestVersion: string | null;
+}
+export interface CommunitySeekAnswerCandidate {
+    kind: "answer";
+    reviewId: string;
+    resourceId: string;
+    title: string;
+    /** 对端 agent 的经验文本(发布侧已过脱敏硬闸 R24)。 */
+    experience: string;
+    outcome: "success" | "fail" | "neutral";
+}
+export type CommunitySeekCandidate = CommunitySeekPackageCandidate | CommunitySeekAnswerCandidate;
+/** 轻回执:落进对话的可折叠"去社区找了个 X"(展示侧由 UI 渲染)。 */
+export interface CommunitySeekReceipt {
+    intent: string;
+    status: CommunityDiscoveryStatus;
+    packageCount: number;
+    answerCount: number;
+    topTitle?: string;
+}
+export interface CommunitySeekResult {
+    status: CommunityDiscoveryStatus;
+    intent: string;
+    packages: CommunitySeekPackageCandidate[];
+    answers: CommunitySeekAnswerCandidate[];
+}
+export interface CommunitySeekDeps {
+    /** 发现协调器:本地前置 + consent + 缓存 + ≤1 次 O(1) registry_match。 */
+    discover(intent: string): Promise<CommunityDiscoveryResult>;
+    /** 经验答案源(Cut1 默认无:hub registry_match 扩返经验答案后接入)。 */
+    findAnswers?(intent: string, topK: number): Promise<CommunitySeekAnswerCandidate[]>;
+    /** 轻回执 sink(对话侧渲染);best-effort,抛错不影响工具结果。 */
+    onReceipt?(receipt: CommunitySeekReceipt): void;
+}
+export declare function toPackageCandidate(match: CommunityRegistryMatchResult): CommunitySeekPackageCandidate;
+export declare function runCommunitySeek(deps: CommunitySeekDeps, params: CommunitySeekParams): Promise<CommunitySeekResult>;
+export declare const COMMUNITY_SEEK_TOOL_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly intent: {
+            readonly type: "string";
+            readonly description: string;
+        };
+        readonly kinds: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+                readonly enum: readonly ["package", "answer"];
+            };
+            readonly description: "Restrict results to packages and/or answers. Omit for both.";
+        };
+    };
+    readonly required: readonly ["intent"];
+};
+export declare function createCommunitySeekTool(deps: CommunitySeekDeps): PortableTool<CommunitySeekParams>;