export interface ParamDef { type: "string" | "number" | "boolean" | "array" | "object"; required: boolean; description?: string; enum?: readonly string[]; items?: ParamDef; properties?: Record; } export interface ToolMeta { name: string; label: string; description: string; promptSnippet: string; promptGuidelines?: readonly string[]; executionMode: "sequential" | "parallel"; params: Record; } export declare const STORABLE_KINDS: readonly ["personalization", "reference", "decision", "procedure", "resource", "observation", "domain"]; export declare const ALL_KINDS: readonly ["personalization", "reference", "decision", "procedure", "resource", "observation", "domain", "index", "log"]; export declare const TEMPLATE_KINDS: readonly ["personalization", "reference", "decision", "procedure", "resource", "observation", "domain", "log"]; export declare const PUBLISHABLE_KINDS: ("personalization" | "reference" | "decision" | "procedure" | "resource" | "observation")[]; export declare const STATUSES: readonly ["fleeting", "permanent", "archived"]; export declare const LIFECYCLES: readonly ["living", "snapshot", "append-only"]; export declare const MAINTAIN_ACTIONS: readonly ["promote", "archive", "delete", "rebuild", "format", "upgrade", "upgrade-read", "upgrade-apply", "review", "dedupe", "embed", "agent-docs", "scope-audit", "scope-inventory", "assign-project", "preference-audit", "unlinked", "broken-links", "link-health", "migrate-layout", "upgrade-vault", "full", "publish-global", "global-reference-audit", "project-authority-review"]; export declare const PUBLISH_GLOBAL_CANDIDATE_PROPERTIES: Record; export declare const TOOL_DEFINITIONS: readonly [{ readonly name: "knowledge-store"; readonly label: "Store Knowledge"; readonly description: string; readonly promptSnippet: "Store qualified durable cross-session memory in open-zk-kb."; readonly promptGuidelines: readonly ["Use knowledge-store promptly when the user explicitly asks you to remember qualified enduring knowledge; apply the precision gate and do not store transient or authoritative-elsewhere content."]; readonly executionMode: "sequential"; readonly params: { readonly title: { readonly type: "string"; readonly required: true; readonly description: "Note title — 3-6 word scannable label (max 10 words / 80 chars). Detail belongs in summary."; }; readonly content: { readonly type: "string"; readonly required: true; readonly description: "Note content — the knowledge to store"; }; readonly kind: { readonly type: "string"; readonly required: true; readonly description: "Note kind: personalization, reference, decision, procedure, resource, observation, domain"; readonly enum: readonly ["personalization", "reference", "decision", "procedure", "resource", "observation", "domain"]; }; readonly summary: { readonly type: "string"; readonly required: true; readonly description: "One-line present-tense key takeaway"; }; readonly guidance: { readonly type: "string"; readonly required: true; readonly description: "Imperative actionable instruction for agents"; }; readonly status: { readonly type: "string"; readonly required: false; readonly description: "Override default status (defaults based on kind)"; readonly enum: readonly ["fleeting", "permanent", "archived"]; }; readonly lifecycle: { readonly type: "string"; readonly required: false; readonly description: "Note lifecycle: living (mutable), snapshot (immutable), append-only (additive only). Defaults per kind."; readonly enum: readonly ["living", "snapshot", "append-only"]; }; readonly tags: { readonly type: "array"; readonly required: false; readonly description: "Tags for categorization"; readonly items: { readonly type: "string"; readonly required: true; }; }; readonly project: { readonly type: "string"; readonly required: true; readonly description: "Current project scope — adds exactly one project: tag"; }; readonly client: { readonly type: "string"; readonly required: false; readonly description: "Client identifier (e.g. claude-code, opencode). Auto-detected from content when omitted."; }; readonly related: { readonly type: "array"; readonly required: false; readonly description: "IDs of related notes to link via wikilinks"; readonly items: { readonly type: "string"; readonly required: true; }; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier (e.g. claude-opus-4, gpt-4o)."; }; readonly dryRun: { readonly type: "boolean"; readonly required: false; readonly description: "Screen without mutation."; }; readonly disposition: { readonly type: "string"; readonly required: false; readonly enum: readonly ["create", "update", "skip"]; readonly description: "Explicit reviewed operation."; }; readonly noteId: { readonly type: "string"; readonly required: false; readonly description: "Reviewed update target ID."; }; readonly expectedUpdatedAt: { readonly type: "number"; readonly required: false; readonly description: "Optimistic update version from preview."; }; readonly confirm: { readonly type: "boolean"; readonly required: false; readonly description: "Confirm the reviewed operation."; }; readonly token: { readonly type: "string"; readonly required: false; readonly description: "Operation-specific token returned by preview."; }; }; }, { readonly name: "knowledge-ingest"; readonly label: "Ingest Knowledge Source"; readonly description: string; readonly promptSnippet: "Extract URL or HTML content before storing useful resources in open-zk-kb."; readonly executionMode: "parallel"; readonly params: { readonly url: { readonly type: "string"; readonly required: false; readonly description: string; }; readonly html: { readonly type: "string"; readonly required: false; readonly description: string; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier (e.g. claude-opus-4, gpt-4o). Enables richer responses for capable models."; }; }; }, { readonly name: "knowledge-search"; readonly label: "Search Knowledge"; readonly description: string; readonly promptSnippet: "Search open-zk-kb for relevant prior context and guidance."; readonly promptGuidelines: readonly ["Use knowledge-search before work that may benefit from prior cross-session memory; pass client: \"pi\" for Pi-specific context. Use compact mode for relevance-gated retrieval, then call knowledge-get with the exact returned noteId, project, and client when present."]; readonly executionMode: "parallel"; readonly params: { readonly query: { readonly type: "string"; readonly required: true; readonly description: "Search query — natural language or keywords. Supports semantic matching when embeddings are enabled."; }; readonly kind: { readonly type: "string"; readonly required: false; readonly description: "Filter by note kind"; readonly enum: readonly ["personalization", "reference", "decision", "procedure", "resource", "observation", "domain", "index", "log"]; }; readonly status: { readonly type: "string"; readonly required: false; readonly description: "Filter by status"; readonly enum: readonly ["fleeting", "permanent", "archived"]; }; readonly lifecycle: { readonly type: "string"; readonly required: false; readonly description: "Filter by lifecycle: living, snapshot, append-only"; readonly enum: readonly ["living", "snapshot", "append-only"]; }; readonly project: { readonly type: "string"; readonly required: true; readonly description: "Current project; searches this project plus explicit global knowledge"; }; readonly client: { readonly type: "string"; readonly required: false; readonly description: string; }; readonly tags: { readonly type: "array"; readonly required: false; readonly description: "Filter by tags (all must match)"; readonly items: { readonly type: "string"; readonly required: true; }; }; readonly limit: { readonly type: "number"; readonly required: false; readonly description: "Max results (full default 10; compact default 5 and maximum 10)"; }; readonly mode: { readonly type: "string"; readonly required: false; readonly description: "Additive response mode: compact returns bounded metadata plus exact knowledge-get pointers; full content remains the default"; readonly enum: readonly ["full", "compact"]; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier (e.g. claude-opus-4, gpt-4o). Enables richer responses for capable models."; }; }; }, { readonly name: "knowledge-context"; readonly label: "Knowledge Context"; readonly description: string; readonly promptSnippet: "Load retained project memory only when it can materially affect the task."; readonly promptGuidelines: readonly ["Use knowledge-context only when retained memory can materially affect the task; treat canonical project artifacts as authoritative."]; readonly executionMode: "parallel"; readonly params: { readonly project: { readonly type: "string"; readonly required: true; readonly description: "Current project whose visible context is requested"; }; readonly logEntries: { readonly type: "number"; readonly required: false; readonly description: "Number of recent log entries to show (default: 10)"; }; readonly includePreferences: { readonly type: "boolean"; readonly required: false; readonly description: "Include a structured capsule of matching permanent preferences"; }; readonly preferenceOnly: { readonly type: "boolean"; readonly required: false; readonly description: "Return only the structured preference capsule without overview content"; }; readonly client: { readonly type: "string"; readonly required: false; readonly description: "Client target used to match scoped preferences"; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier (e.g. claude-opus-4, gpt-4o). Enables richer responses for capable models."; }; }; }, { readonly name: "knowledge-open"; readonly label: "Open in Obsidian"; readonly description: string; readonly promptSnippet: "Open open-zk-kb notes in Obsidian for human review when requested."; readonly executionMode: "sequential"; readonly params: { readonly project: { readonly type: "string"; readonly required: false; readonly description: "Open focused on a specific project's index note"; }; }; }, { readonly name: "knowledge-get"; readonly label: "Get Knowledge Note"; readonly description: string; readonly promptSnippet: "Fetch a specific open-zk-kb note by ID for fast retrieval."; readonly executionMode: "parallel"; readonly params: { readonly noteId: { readonly type: "string"; readonly required: true; readonly description: "Exact note ID to retrieve"; }; readonly project: { readonly type: "string"; readonly required: true; readonly description: "Current project used to validate note visibility"; }; readonly client: { readonly type: "string"; readonly required: false; readonly description: "Optional client applicability filter"; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier (e.g. claude-opus-4, gpt-4o). Enables richer responses for capable models."; }; }; }, { readonly name: "knowledge-health"; readonly label: "Knowledge Health"; readonly description: string; readonly promptSnippet: "Check open-zk-kb vault health, staleness, and growth metrics."; readonly executionMode: "parallel"; readonly params: { readonly project: { readonly type: "string"; readonly required: true; readonly description: "Current project for scoped note metrics"; }; readonly client: { readonly type: "string"; readonly required: false; readonly description: "Optional client applicability filter for scoped note metrics"; }; readonly period: { readonly type: "string"; readonly required: false; readonly description: "Time window: \"7d\", \"30d\", \"90d\" (default \"30d\")"; }; readonly telemetry: { readonly type: "boolean"; readonly required: false; readonly description: "Include tool usage and template conformance metrics (requires telemetry.enabled config)"; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier (e.g. claude-opus-4, gpt-4o). Enables richer responses for capable models."; }; }; }, { readonly name: "knowledge-maintain"; readonly label: "Maintain Knowledge"; readonly description: string; readonly promptSnippet: "Inspect or maintain open-zk-kb health and lifecycle state."; readonly executionMode: "sequential"; readonly params: { readonly action: { readonly type: "string"; readonly required: true; readonly description: string; readonly enum: readonly ["promote", "archive", "delete", "rebuild", "format", "upgrade", "upgrade-read", "upgrade-apply", "review", "dedupe", "embed", "agent-docs", "scope-audit", "scope-inventory", "assign-project", "preference-audit", "unlinked", "broken-links", "link-health", "migrate-layout", "upgrade-vault", "full", "publish-global", "global-reference-audit", "project-authority-review"]; }; readonly noteId: { readonly type: "string"; readonly required: false; readonly description: "Note ID (required for promote/archive/delete/assign-project; source note ID for publish-global; migration ID for upgrade-read)"; }; readonly project: { readonly type: "string"; readonly required: false; readonly description: "Target project (required for assign-project and project-authority-review)"; }; readonly filter: { readonly type: "string"; readonly required: false; readonly description: "Filter for review action: fleeting or permanent notes"; readonly enum: readonly ["fleeting", "permanent"]; }; readonly days: { readonly type: "number"; readonly required: false; readonly description: "Days threshold for review (default: from lifecycle.reviewAfterDays config)"; }; readonly limit: { readonly type: "number"; readonly required: false; readonly description: "Max notes to show (default: 3 for review)"; }; readonly dryRun: { readonly type: "boolean"; readonly required: false; readonly description: "Preview changes without applying"; }; readonly candidate: { readonly type: "object"; readonly required: false; readonly description: "Distilled global candidate for publish-global action (required when action is publish-global)"; readonly properties: Record; }; readonly confirm: { readonly type: "boolean"; readonly required: false; readonly description: "Explicit confirmation required for publish-global or assign-project apply"; }; readonly token: { readonly type: "string"; readonly required: false; readonly description: "Confirmation token from publish-global or assign-project preview (required for apply)"; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier (e.g. claude-opus-4, gpt-4o). Enables richer responses for capable models."; }; }; }, { readonly name: "knowledge-mine"; readonly label: "Mine Knowledge"; readonly description: string; readonly promptSnippet: "Mine previous sessions for candidate open-zk-kb notes."; readonly executionMode: "sequential"; readonly params: { readonly candidates: { readonly type: "array"; readonly required: true; readonly description: "Array of candidate notes extracted from session history"; readonly items: { readonly type: "object"; readonly required: true; readonly properties: Record; }; }; readonly project: { readonly type: "string"; readonly required: true; readonly description: "Current project for duplicate screening and stored candidates"; }; readonly client: { readonly type: "string"; readonly required: false; readonly description: "Optional client applicability filter for duplicate screening"; }; readonly dry_run: { readonly type: "boolean"; readonly required: false; readonly description: "Preview dedup results without storing (default: true)"; }; readonly dispositions: { readonly type: "array"; readonly required: false; readonly description: "Candidate-keyed reviewed plan."; readonly items: { readonly type: "object"; readonly required: true; readonly properties: { readonly candidateKey: { readonly type: "string"; readonly required: true; }; readonly action: { readonly type: "string"; readonly required: true; readonly enum: readonly ["store", "update", "skip"]; }; readonly noteId: { readonly type: "string"; readonly required: false; }; readonly expectedUpdatedAt: { readonly type: "number"; readonly required: false; }; readonly token: { readonly type: "string"; readonly required: false; }; }; }; }; readonly batchToken: { readonly type: "string"; readonly required: false; readonly description: "Token binding the ordered batch and plan."; }; readonly confirm: { readonly type: "boolean"; readonly required: false; readonly description: "Confirm application of the reviewed plan."; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier for richer responses"; }; }; }, { readonly name: "knowledge-template"; readonly label: "Knowledge Template"; readonly description: string; readonly promptSnippet: "Load an open-zk-kb note template before storing structured knowledge."; readonly promptGuidelines: readonly ["Use knowledge-template before knowledge-store when creating a structured note kind for the first time in a session."]; readonly executionMode: "parallel"; readonly params: { readonly kind: { readonly type: "string"; readonly required: true; readonly description: "Note kind to get the canonical template for"; readonly enum: readonly ["personalization", "reference", "decision", "procedure", "resource", "observation", "domain", "log"]; }; readonly project: { readonly type: "string"; readonly required: false; readonly description: "Project name — checks for project-specific template overrides"; }; readonly model: { readonly type: "string"; readonly required: false; readonly description: "Your model identifier"; }; }; }]; //# sourceMappingURL=tool-meta.d.ts.map