principles-disciple 1.201.1 → 1.202.1

package/dist/commands/archive-impl.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Archive Implementation Command — CLI `/pd-archive-impl`
+ * ========================================================
+ *
+ * PURPOSE: Permanently archive an implementation (disabled -> archived,
+ * active -> archived, or candidate -> archived).
+ *
+ * Used for permanent cleanup of implementations that are no longer relevant.
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handle the /pd-archive-impl command.
+ *
+ * Usage:
+ *   /pd-archive-impl <implId>   - Archive an implementation
+ *   /pd-archive-impl list       - List archivable implementations
+ */
+export declare function handleArchiveImplCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/capabilities.d.ts

@@ -0,0 +1,3 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleBootstrapTools(ctx: PluginCommandContext): PluginCommandResult;
+export declare function handleResearchTools(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/context.d.ts

@@ -0,0 +1,5 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Main command handler
+ */
+export declare function handleContextCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/disable-impl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Disable Implementation Command — CLI `/pd-disable-impl`
+ * ========================================================
+ *
+ * PURPOSE: Manually disable an active implementation (e.g., regression in production).
+ *
+ * FLOW:
+ *   1. List active implementations
+ *   2. Select target, ask for reason
+ *   3. Transition active -> disabled (or candidate -> disabled)
+ *   4. Record disabledAt, disabledBy, disabledReason
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handle the /pd-disable-impl command.
+ *
+ * Usage:
+ *   /pd-disable-impl list                        - List active implementations
+ *   /pd-disable-impl <implId>                    - Disable an implementation
+ *   /pd-disable-impl <implId> --reason "<reason>" - Disable with reason
+ */
+export declare function handleDisableImplCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/evolution-status.d.ts

@@ -0,0 +1,4 @@
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+export declare function handleEvolutionStatusCommand(ctx: PluginCommandContext): {
+    text: string;
+};

package/dist/commands/export.d.ts

@@ -0,0 +1,2 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleExportCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/focus.d.ts

@@ -0,0 +1,14 @@
+/**
+ * /pd-focus 命令 - 管理 CURRENT_FOCUS.md
+ *
+ * 功能：
+ * - status: 查看当前状态和历史版本
+ * - compress: 手动压缩并备份
+ * - history: 查看历史版本列表
+ * - rollback: 回滚到指定历史版本
+ */
+import type { PluginCommandContext, PluginCommandResult, OpenClawPluginApi } from '../openclaw-sdk.js';
+/**
+ * 处理 /pd-focus 命令
+ */
+export declare function handleFocusCommand(ctx: PluginCommandContext, api: OpenClawPluginApi): Promise<PluginCommandResult>;

package/dist/commands/pain.d.ts

@@ -0,0 +1,6 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handles the /pd-status command
+ */
+export declare function handlePainCommand(ctx: PluginCommandContext): PluginCommandResult;
+export declare function handlePainReportCommand(ctx: PluginCommandContext): Promise<PluginCommandResult>;

package/dist/commands/principle-rollback.d.ts

@@ -0,0 +1,4 @@
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+export declare function handlePrincipleRollbackCommand(ctx: PluginCommandContext): {
+    text: string;
+};

package/dist/commands/promote-impl.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Promote Implementation Command — CLI `/pd-promote-impl`
+ * ========================================================
+ *
+ * PURPOSE: Manually promote a candidate implementation to active status
+ * after replay evaluation review.
+ *
+ * FLOW:
+ *   1. List candidates with replay reports
+ *   2. Show replay report summary for selected candidate
+ *   3. Ask for confirmation
+ *   4. On confirm: transition candidate->active, demote previous active->disabled
+ *
+ * VALIDATION:
+ *   - Candidate must have at least one replay report with 'pass' decision
+ *   - Only candidate -> active is valid for promotion
+ *   - NOTE (PRI-230): The legacy replay generation path has been retired.
+ *     This command is temporarily unavailable for implementations without
+ *     pre-existing replay reports until a Runtime V2 replay entry is wired.
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handlePromoteImplCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/rollback-impl.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Rollback Implementation Command — CLI `/pd-rollback-impl`
+ * ==========================================================
+ *
+ * PURPOSE: Revert the current active implementation and restore the previous one.
+ *
+ * FLOW:
+ *   1. List active implementations
+ *   2. On confirm: current -> disabled, previous -> active
+ *
+ * SAFETY:
+ *   - If no previous active: current -> disabled (degrades to hard-boundary gates)
+ *   - Rollback records persisted with full audit trail
+ */
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handle the /pd-rollback-impl command.
+ *
+ * Usage:
+ *   /pd-rollback-impl list                          - List active implementations
+ *   /pd-rollback-impl <implId>                      - Rollback current active
+ *   /pd-rollback-impl <implId> --reason "<reason>"  - Rollback with reason
+ */
+export declare function handleRollbackImplCommand(ctx: PluginCommandContext): PluginCommandResult;
+/**
+ * Handle natural language rollback request.
+ * Detects phrases like "回滚这个规则实现", "rollback this implementation".
+ */
+export declare function handleNaturalLanguageRollbackImpl(workspaceDir: string, sessionId: string | undefined, reason: string): {
+    success: boolean;
+    message: string;
+};

package/dist/commands/rollback.d.ts

@@ -0,0 +1,19 @@
+import { WorkspaceContext } from '../core/workspace-context.js';
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+/**
+ * Handles the /pd-rollback command
+ *
+ * Usage:
+ *   /pd-rollback <event-id>  - Rollback a specific empathy event by ID
+ *   /pd-rollback last        - Rollback the last empathy event in current session
+ */
+export declare function handleRollbackCommand(ctx: PluginCommandContext): PluginCommandResult;
+/**
+ * Handle natural language rollback request
+ * Called from prompt hook when user says things like "撤销刚才的惩罚"
+ */
+export declare function handleNaturalLanguageRollback(wctx: WorkspaceContext, sessionId: string | undefined, reason: string): {
+    success: boolean;
+    score: number;
+    message: string;
+};

package/dist/commands/samples.d.ts

@@ -0,0 +1,2 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleSamplesCommand(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/strategy.d.ts

@@ -0,0 +1,2 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleInitStrategy(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/thinking-os.d.ts

@@ -0,0 +1,2 @@
+import type { PluginCommandContext, PluginCommandResult } from '../openclaw-sdk.js';
+export declare function handleThinkingOs(ctx: PluginCommandContext): PluginCommandResult;

package/dist/commands/workflow-debug.d.ts

@@ -0,0 +1,4 @@
+import type { PluginCommandContext } from '../openclaw-sdk.js';
+export declare function handleWorkflowDebugCommand(ctx: PluginCommandContext): {
+    text: string;
+};

package/dist/config/defaults/runtime.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Centralized Runtime Defaults
+ *
+ * All runtime-related constants that were previously scattered across modules.
+ * Centralizing these makes it easier to tune behavior and understand limits.
+ */
+/** Milliseconds per second */
+export declare const MS_PER_SECOND = 1000;
+/** Seconds per minute */
+export declare const SECONDS_PER_MINUTE = 60;
+/** Minutes per hour */
+export declare const MINUTES_PER_HOUR = 60;
+/** Hours per day */
+export declare const HOURS_PER_DAY = 24;
+/** Days per week */
+export declare const DAYS_PER_WEEK = 7;
+/** One minute in milliseconds */
+export declare const ONE_MINUTE_MS: number;
+/** One hour in milliseconds */
+export declare const ONE_HOUR_MS: number;
+/** One day in milliseconds */
+export declare const ONE_DAY_MS: number;
+/** One week in milliseconds */
+export declare const ONE_WEEK_MS: number;
+/** Default TTL for helper workflows (5 minutes) */
+export declare const WORKFLOW_TTL_MS: number;
+/** Default workflow timeout (15 minutes) */
+export declare const WORKFLOW_TIMEOUT_MS: number;
+/** Default workflow sweep interval (30 minutes) */
+export declare const WORKFLOW_SWEEP_MS: number;
+/**
+ * Trajectory gate block retry settings
+ * Used when trajectory recording fails and needs to retry
+ */
+export declare const TRAJECTORY_GATE_BLOCK_RETRY_DELAY_MS = 250;
+export declare const TRAJECTORY_GATE_BLOCK_MAX_RETRIES = 3;
+export declare const THINKING_CHECKPOINT_WINDOW_MS: number;
+export declare const THINKING_CHECKPOINT_DEFAULT_HIGH_RISK_TOOLS: readonly ['run_shell_command', 'delete_file', 'move_file'];
+/** Large change threshold for GFI gate adjustments */
+export declare const GFI_LARGE_CHANGE_LINES = 50;
+/** Agent spawn GFI threshold (critically high = no spawn) */
+export declare const AGENT_SPAWN_GFI_THRESHOLD = 90;
+/** Evolution worker polling interval (15 minutes) */
+export declare const EVOLUTION_WORKER_POLL_INTERVAL_MS: number;
+/** Evolution queue batch size */
+export declare const EVOLUTION_QUEUE_BATCH_SIZE = 10;
+export declare const SESSION_TOKEN_WARNING_THRESHOLD = 8000;
+export declare const SESSION_MAX_IDLE_MS: number;
+export declare const EVENT_LOG_BUFFER_SIZE = 20;
+export declare const EVENT_LOG_FLUSH_INTERVAL_MS: number;
+/** Default busy timeout for SQLite operations (5 seconds) */
+export declare const DEFAULT_BUSY_TIMEOUT_MS: number;
+/** Max string length for trajectory/event logs */
+export declare const MAX_STRING_LENGTH = 1000;
+/** Default max file size (10MB) */
+export declare const MAX_FILE_SIZE_BYTES: number;
+/** Two hours in milliseconds */
+export declare const TWO_HOURS_MS: number;

package/dist/config/errors.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Domain-Specific Errors for Principles Disciple
+ *
+ * These errors provide semantic meaning to failure modes,
+ * making it easier to distinguish between:
+ * - Lock contention (resource busy)
+ * - Parse/validation failures
+ * - Derived state mismatches
+ * - Configuration issues
+ */
+import type { PDErrorCategory } from '@principles/core';
+/**
+ * Base class for all Principles Disciple errors
+ */
+export declare class PdError extends Error {
+    readonly code: string;
+    readonly category: PDErrorCategory;
+    constructor(message: string, code: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a resource lock cannot be acquired
+ * (e.g., queue, trajectory, evolution file)
+ */
+export declare class LockUnavailableError extends PdError {
+    constructor(resource: string, scope: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a path key cannot be resolved
+ */
+export declare class PathResolutionError extends PdError {
+    constructor(key: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a workspace cannot be found
+ */
+export declare class WorkspaceNotFoundError extends PdError {
+    constructor(workspace: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when a required sample cannot be found
+ */
+export declare class SampleNotFoundError extends PdError {
+    constructor(sampleId: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when configuration is invalid or missing required fields
+ */
+export declare class ConfigurationError extends PdError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when prompt/logger dependencies are unavailable
+ */
+export declare class DependencyError extends PdError {
+    constructor(component: string, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when evolution worker encounters a processing error
+ */
+export declare class EvolutionProcessingError extends PdError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Thrown when trajectory operations fail
+ */
+export declare class TrajectoryError extends PdError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}

package/dist/config/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Configuration module for Principles Disciple
+ *
+ * Centralizes all configuration defaults, types, and domain errors.
+ */
+export * from './defaults/runtime.js';
+export * from './errors.js';

package/dist/constants/tools.d.ts

@@ -0,0 +1,17 @@
+export declare const READ_ONLY_TOOL_NAMES: readonly ['read', 'read_file', 'read_many_files', 'image_read', 'search_file_content', 'grep', 'grep_search', 'list_directory', 'ls', 'glob', 'lsp_hover', 'lsp_goto_definition', 'lsp_find_references', 'web_fetch', 'web_search', 'ref_search_documentation', 'ref_read_url', 'resolve-library-id', 'get-library-docs', 'memory_recall', 'save_memory', 'todo_read', 'todo_write', 'ask_user', 'ask_user_question', 'pd-status', 'report'];
+export declare const LOW_RISK_WRITE_TOOL_NAMES: readonly ['write', 'write_file', 'edit', 'edit_file', 'replace', 'apply_patch', 'insert', 'patch'];
+export declare const BASH_TOOL_NAMES: readonly ['bash', 'run_shell_command', 'exec', 'execute', 'shell', 'cmd'];
+export declare const HIGH_RISK_TOOL_NAMES: readonly ["delete_file", "move_file", "bash", "run_shell_command", "exec", "execute", "shell", "cmd"];
+export declare const AGENT_TOOL_NAMES: readonly ['sessions_spawn'];
+export declare const CONTENT_LIMITED_TOOL_NAMES: readonly ["write", "write_file", "edit", "edit_file", "replace", "apply_patch", "insert", "patch"];
+export declare const CONSTRUCTIVE_TOOL_NAMES: readonly ["write", "write_file", "edit", "edit_file", "replace", "apply_patch", "insert", "patch", "delete_file", "move_file", "bash", "run_shell_command", "exec", "execute", "shell", "cmd", "sessions_spawn", "evolve-task", "init-strategy"];
+export declare const EXPLORATORY_TOOL_NAMES: readonly ["read", "read_file", "read_many_files", "image_read", "search_file_content", "grep", "grep_search", "list_directory", "ls", "glob", "lsp_hover", "lsp_goto_definition", "lsp_find_references", "web_fetch", "web_search", "ref_search_documentation", "ref_read_url", "resolve-library-id", "get-library-docs", "memory_recall", "save_memory", "todo_read", "todo_write", "ask_user", "ask_user_question", "pd-status", "report"];
+export declare const READ_ONLY_TOOLS: Set<string>;
+export declare const LOW_RISK_WRITE_TOOLS: Set<string>;
+export declare const HIGH_RISK_TOOLS: Set<string>;
+export declare const BASH_TOOLS_SET: Set<string>;
+export declare const AGENT_TOOLS: Set<string>;
+export declare const CONTENT_LIMITED_TOOLS: Set<string>;
+export declare const CONSTRUCTIVE_TOOLS: Set<string>;
+export declare const EXPLORATORY_TOOLS: Set<string>;
+export declare const WRITE_TOOLS: Set<string>;

package/dist/core/__tests__/focus-history.test.d.ts

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

package/dist/core/behavior-example-pack-assembler.d.ts

@@ -0,0 +1,38 @@
+import type { BehaviorExamplePack } from '@principles/core/runtime-v2';
+export interface BehaviorExamplePackAssemblerOptions {
+    /** Workspace directory — used to obtain the shared TrajectoryDatabase. */
+    readonly workspaceDir: string;
+    /**
+     * State directory (unused for direct DB access but required by the
+     * WorkspaceContext facade pattern; future-proofing for redaction config).
+     */
+    readonly stateDir: string;
+}
+export interface BehaviorExamplePackAssemblerInput {
+    /** Canonical pain ID (e.g. pain_<ts>_<hash>) — entry point into pain lineage. */
+    readonly sourcePainId: string;
+    /** Owner's natural-language desired outcome — must be non-empty. */
+    readonly ownerDesiredOutcome: string;
+    /** Owner-selected call that demonstrates behaviour to block. */
+    readonly sourceNegativeToolCallId: number;
+    /** Owner-selected calls that demonstrate behaviour to allow (1..3). */
+    readonly positiveToolCallIds: readonly number[];
+    /**
+     * Project directory, used to detect absolute paths that should be redacted
+     * to relative/basename form in the assembled pack.
+     */
+    readonly projectDir: string;
+}
+/**
+ * Plugin I/O assembler: pain lineage + trajectory → validated BehaviorExamplePack.
+ *
+ * Lifecycle: cheap to construct; obtains TrajectoryDatabase via the registry.
+ * Dispose is the registry's responsibility (singleton per workspace).
+ */
+export declare class BehaviorExamplePackAssembler {
+    private readonly db;
+    constructor(opts: BehaviorExamplePackAssemblerOptions);
+    /** Assemble only from explicit Owner labels; execution outcome is not a label. */
+    assemble(input: BehaviorExamplePackAssemblerInput): BehaviorExamplePack;
+    private buildSelectedCase;
+}

package/dist/core/bootstrap-rules.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Minimal Rule Bootstrap (Phase 17)
+ *
+ * Bootstraps 1-3 stub Rule entities for high-value deterministic principles.
+ * Selected by: observedViolationCount (descending) + evaluability=deterministic.
+ * Falls back to all deterministic principles if violation data is sparse.
+ *
+ * Rule ID format: {principleId}_stub_bootstrap
+ * Scope: BOOT-03 — bounded, no mass migration, no implementations.
+ *
+ * Usage:
+ *   npx vitest run tests/core/bootstrap-rules.test.ts   (tests)
+ *   npm run bootstrap-rules                               (production)
+ */
+export interface BootstrapResult {
+    principleId: string;
+    ruleId: string;
+    status: 'created' | 'skipped';
+}
+/**
+ * Select principles for bootstrap based on violation count and evaluability.
+ *
+ * @param stateDir - State directory path
+ * @param limit - Maximum number of principles to select (default: 3)
+ * @returns Array of principle IDs sorted by observedViolationCount (descending)
+ * @throws Error if no deterministic principles found
+ */
+export declare function selectPrinciplesForBootstrap(stateDir: string, limit?: number): string[];
+/**
+ * Bootstrap stub rules for selected principles.
+ *
+ * Creates stub Rule entities with format {principleId}_stub_bootstrap.
+ * Links rules to principles via suggestedRules array.
+ * Idempotent: skips existing rules.
+ *
+ * @param stateDir - State directory path
+ * @param limit - Maximum number of principles to bootstrap (default: 3)
+ * @returns Array of results indicating created or skipped status
+ * @throws Error if no deterministic principles found
+ */
+export declare function bootstrapRules(stateDir: string, limit?: number): BootstrapResult[];
+/**
+ * Validate that bootstrapped state is correct.
+ *
+ * @param stateDir - State directory path
+ * @param expectedPrincipleIds - Principle IDs that should be bootstrapped
+ * @returns true if validation passes
+ * @throws Error if validation fails
+ */
+export declare function validateBootstrap(stateDir: string, expectedPrincipleIds: string[]): boolean;

package/dist/core/code-implementation-storage.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Code Implementation Asset Storage
+ * ================================
+ *
+ * Manages versioned code implementation assets: manifests, entry files,
+ * and metadata pointers for Implementation(type=code) records.
+ *
+ * DESIGN CONSTRAINTS (per D-09 through D-12):
+ *   - Manifest is loading metadata, NOT the source of truth for lifecycle state (D-11)
+ *   - The Principle Tree ledger remains canonical for lifecycle and relationships (D-11)
+ *   - Asset root follows the PD stateDir convention:
+ *     {stateDir}/principles/implementations/{implId}/
+ *   - All writes use withLock for atomicity (matching ledger pattern)
+ *   - This module does NOT implement replay execution, evaluation report generation,
+ *     or promotion logic (D-12)
+ */
+/**
+ * Manifest shape for a code implementation's filesystem assets.
+ * Subordinate to the ledger per D-11: does NOT store lifecycleState.
+ */
+export interface CodeImplementationManifest {
+    /** Asset version (distinct from Implementation.version in the ledger) */
+    version: string;
+    /** Relative filename of the entry point (e.g., 'entry.js') */
+    entryFile: string;
+    /** ISO timestamp of initial creation */
+    createdAt: string;
+    /** ISO timestamp of last manifest update */
+    updatedAt: string;
+    /** Fingerprints of samples this implementation was tested against */
+    replaySampleRefs: string[];
+    /** Relative path to most recent eval report, or null */
+    lastEvalReportRef: string | null;
+    /** Provenance carried with the generated candidate assets */
+    lineage?: CodeImplementationLineageMetadata;
+}
+export interface CodeImplementationLineageMetadata {
+    principleId: string;
+    ruleId: string;
+    sourceSnapshotRef: string;
+    sourcePainIds: string[];
+    sourceGateBlockIds: string[];
+    sourceSessionId: string;
+    artificerArtifactId: string;
+}
+/**
+ * Get the absolute path for an implementation's asset root.
+ * Convention: {stateDir}/principles/implementations/{implId}/
+ */
+export declare function getImplementationAssetRoot(stateDir: string, implId: string): string;
+/**
+ * Write manifest atomically using withLock.
+ */
+export declare function writeManifest(stateDir: string, implId: string, manifest: CodeImplementationManifest): void;
+export declare function writeEntrySource(stateDir: string, implId: string, sourceCode: string, entryFile?: string): void;
+export declare function deleteImplementationAssetDir(stateDir: string, implId: string): void;
+/**
+ * Create the full asset directory structure for a new implementation.
+ *
+ * Creates:
+ *   {implId}/            - asset root
+ *   {implId}/entry.js    - placeholder entry point (only if not already present)
+ *   {implId}/manifest.json - asset manifest with version and timestamps
+ *   {implId}/replays/    - empty directory for future replay reports
+ *
+ * Idempotent: calling again with the same implId will NOT overwrite an existing entry.js.
+ */
+export declare function createImplementationAssetDir(stateDir: string, implId: string, version: string, options?: {
+    entrySource?: string;
+    lineage?: CodeImplementationLineageMetadata;
+}): CodeImplementationManifest;

package/dist/core/config-health.d.ts

@@ -0,0 +1,17 @@
+/**
+ * PRI-348: Extract the full plugin entry (including hooks) from the global OpenClaw config.
+ * Unlike api.pluginConfig (which is only the entry.config sub-object), this returns
+ * the entire entry including hooks, config, enabled, etc.
+ */
+export declare function getPluginEntry(config: unknown, pluginId: string): unknown;
+export interface ConversationAccessCheckResult {
+    authorized: boolean;
+    reason?: string;
+    nextAction?: string;
+}
+/**
+ * PRI-343: Pure function — checks if pluginConfig has hooks.allowConversationAccess === true.
+ * Returns a structured result with reason and nextAction when not authorized (ERR-002).
+ */
+export declare function checkConversationAccessConfig(pluginConfig: unknown): ConversationAccessCheckResult;
+export declare function ensureConversationAccessInConfig(): boolean;

package/dist/core/config-service.d.ts

@@ -0,0 +1,15 @@
+import { PainConfig } from './config.js';
+/**
+ * Singleton service to manage the Pain Configuration.
+ */
+export declare const ConfigService: {
+    /**
+     * Gets or initializes the Pain Configuration instance.
+     * @param stateDir The directory where the settings JSON is stored.
+     */
+    get(stateDir: string): PainConfig;
+    /**
+     * Resets the singleton instance (primarily for testing).
+     */
+    reset(): void;
+};