@autonav/core 1.0.0

package/dist/plugins/config-schema.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+/**
+ * Schema for .claude/plugins.json
+ *
+ * Example:
+ * {
+ *   "slack": {
+ *     "enabled": true,
+ *     "config": {
+ *       "token": "xoxb-...",
+ *       "channels": ["#general"],
+ *       "threadNotifications": true
+ *     }
+ *   },
+ *   "github": {
+ *     "enabled": false,
+ *     "config": {}
+ *   }
+ * }
+ */
+export declare const PluginConfigFileSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
+    enabled: z.ZodBoolean;
+    config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    config?: Record<string, unknown> | undefined;
+}, {
+    enabled: boolean;
+    config?: Record<string, unknown> | undefined;
+}>>;
+export type PluginConfigFile = z.infer<typeof PluginConfigFileSchema>;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/plugins/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/plugins/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;GAMlC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/plugins/config-schema.js

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+/**
+ * Schema for .claude/plugins.json
+ *
+ * Example:
+ * {
+ *   "slack": {
+ *     "enabled": true,
+ *     "config": {
+ *       "token": "xoxb-...",
+ *       "channels": ["#general"],
+ *       "threadNotifications": true
+ *     }
+ *   },
+ *   "github": {
+ *     "enabled": false,
+ *     "config": {}
+ *   }
+ * }
+ */
+export const PluginConfigFileSchema = z.record(z.string(), // Plugin name
+z.object({
+    enabled: z.boolean(),
+    config: z.record(z.unknown()).optional(),
+}));
+//# sourceMappingURL=config-schema.js.map

package/dist/plugins/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/plugins/config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAC5C,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc;AAC1B,CAAC,CAAC,MAAM,CAAC;IACP,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzC,CAAC,CACH,CAAC"}

package/dist/plugins/implementations/file-watcher/index.d.ts

@@ -0,0 +1,110 @@
+import { z } from 'zod';
+import { Plugin, PluginHealthStatus } from '../../types.js';
+export declare const FileWatcherConfigSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString, "many">;
+    patterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    ignorePatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    pollInterval: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    paths: string[];
+    patterns: string[];
+    ignorePatterns: string[];
+    pollInterval: number;
+}, {
+    paths: string[];
+    patterns?: string[] | undefined;
+    ignorePatterns?: string[] | undefined;
+    pollInterval?: number | undefined;
+}>;
+export type FileWatcherConfig = z.infer<typeof FileWatcherConfigSchema>;
+export declare const FileWatcherEventSchema: z.ZodObject<{
+    type: z.ZodEnum<["added", "changed", "removed"]>;
+    path: z.ZodString;
+    timestamp: z.ZodString;
+    size: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "added" | "changed" | "removed";
+    timestamp: string;
+    size?: number | undefined;
+}, {
+    path: string;
+    type: "added" | "changed" | "removed";
+    timestamp: string;
+    size?: number | undefined;
+}>;
+export type FileWatcherEvent = z.infer<typeof FileWatcherEventSchema>;
+export declare const FileWatcherActionSchema: z.ZodObject<{
+    type: z.ZodEnum<["refresh", "clear"]>;
+}, "strip", z.ZodTypeAny, {
+    type: "refresh" | "clear";
+}, {
+    type: "refresh" | "clear";
+}>;
+export type FileWatcherAction = z.infer<typeof FileWatcherActionSchema>;
+/**
+ * File System Watcher Plugin
+ *
+ * Monitors knowledge base files for changes and reports them as events.
+ * Useful for keeping navigators aware of documentation updates.
+ *
+ * Security: Only watches directories within the project scope,
+ * prevents watching sensitive system directories.
+ */
+export declare class FileWatcherPlugin implements Plugin<FileWatcherConfig, FileWatcherEvent, FileWatcherAction> {
+    readonly name = "file-watcher";
+    readonly version = "1.0.0";
+    readonly description = "Monitor file system changes in knowledge base";
+    readonly configSchema: z.ZodObject<{
+        paths: z.ZodArray<z.ZodString, "many">;
+        patterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        ignorePatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        pollInterval: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        paths: string[];
+        patterns: string[];
+        ignorePatterns: string[];
+        pollInterval: number;
+    }, {
+        paths: string[];
+        patterns?: string[] | undefined;
+        ignorePatterns?: string[] | undefined;
+        pollInterval?: number | undefined;
+    }>;
+    readonly eventSchema: z.ZodObject<{
+        type: z.ZodEnum<["added", "changed", "removed"]>;
+        path: z.ZodString;
+        timestamp: z.ZodString;
+        size: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        type: "added" | "changed" | "removed";
+        timestamp: string;
+        size?: number | undefined;
+    }, {
+        path: string;
+        type: "added" | "changed" | "removed";
+        timestamp: string;
+        size?: number | undefined;
+    }>;
+    readonly actionSchema: z.ZodObject<{
+        type: z.ZodEnum<["refresh", "clear"]>;
+    }, "strip", z.ZodTypeAny, {
+        type: "refresh" | "clear";
+    }, {
+        type: "refresh" | "clear";
+    }>;
+    private config?;
+    private watcher?;
+    private pendingEvents;
+    initialize(config: FileWatcherConfig): Promise<void>;
+    private handleEvent;
+    private matchesPatterns;
+    listen(): Promise<FileWatcherEvent[]>;
+    execute(action: FileWatcherAction): Promise<void>;
+    updateConfig(updates: Partial<FileWatcherConfig>): Promise<FileWatcherConfig>;
+    getConfig(): FileWatcherConfig;
+    healthCheck(): Promise<PluginHealthStatus>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/implementations/file-watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/implementations/file-watcher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAK5D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;EASlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;EAKjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAGtE,eAAO,MAAM,uBAAuB;;;;;;EAElC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAoDxE;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,MAAM,CAC9C,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,CAClB;IACC,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,mDAAmD;IACvE,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;OAA2B;IAChD,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;OAA0B;IAC9C,QAAQ,CAAC,YAAY;;;;;;OAA2B;IAEhD,OAAO,CAAC,MAAM,CAAC,CAAoB;IACnC,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,aAAa,CAA0B;IAEzC,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;YAiC5C,WAAW;IAwBzB,OAAO,CAAC,eAAe;IAOjB,MAAM,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAMrC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjD,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAcnF,SAAS,IAAI,iBAAiB;IAOxB,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAgC1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC"}

package/dist/plugins/implementations/file-watcher/index.js

@@ -0,0 +1,212 @@
+import { z } from 'zod';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { watch } from 'chokidar';
+import micromatch from 'micromatch';
+// Configuration schema
+export const FileWatcherConfigSchema = z.object({
+    paths: z.array(z.string()).describe('Directories to watch'),
+    patterns: z.array(z.string()).default(['**/*.md']).describe('Glob patterns to match'),
+    ignorePatterns: z.array(z.string()).default([
+        '**/node_modules/**',
+        '**/.git/**',
+        '**/dist/**',
+    ]).describe('Patterns to ignore'),
+    pollInterval: z.number().default(1000).describe('Polling interval in ms'),
+});
+// Event schema
+export const FileWatcherEventSchema = z.object({
+    type: z.enum(['added', 'changed', 'removed']),
+    path: z.string(),
+    timestamp: z.string(),
+    size: z.number().optional(),
+});
+// Action schema (minimal for this plugin)
+export const FileWatcherActionSchema = z.object({
+    type: z.enum(['refresh', 'clear']),
+});
+/**
+ * Sensitive directories that should never be watched
+ */
+const FORBIDDEN_PATHS = [
+    '/etc',
+    '/sys',
+    '/proc',
+    '/dev',
+    '/root',
+    '/boot',
+    '/var/log',
+    '/usr/bin',
+    '/usr/sbin',
+    '/bin',
+    '/sbin',
+    process.env.HOME + '/.ssh',
+    process.env.HOME + '/.aws',
+    process.env.HOME + '/.config',
+    '/Windows',
+    '/System',
+    'C:\\Windows',
+    'C:\\System',
+];
+/**
+ * Validate that a path is safe to watch
+ * Prevents watching sensitive system directories
+ */
+function validateSafePath(watchPath) {
+    const resolved = path.resolve(watchPath);
+    // Check if path starts with any forbidden path
+    for (const forbidden of FORBIDDEN_PATHS) {
+        if (forbidden && resolved.startsWith(forbidden)) {
+            throw new Error(`Security: Cannot watch sensitive directory '${watchPath}'. ` +
+                `File watcher is restricted to project directories only.`);
+        }
+    }
+    // Warn if watching root or very high-level directories
+    if (resolved === '/' || resolved === 'C:\\' || resolved.split(path.sep).length <= 2) {
+        throw new Error(`Security: Cannot watch root or high-level directory '${watchPath}'. ` +
+            `Please specify a more specific directory within your project.`);
+    }
+}
+/**
+ * File System Watcher Plugin
+ *
+ * Monitors knowledge base files for changes and reports them as events.
+ * Useful for keeping navigators aware of documentation updates.
+ *
+ * Security: Only watches directories within the project scope,
+ * prevents watching sensitive system directories.
+ */
+export class FileWatcherPlugin {
+    name = 'file-watcher';
+    version = '1.0.0';
+    description = 'Monitor file system changes in knowledge base';
+    configSchema = FileWatcherConfigSchema;
+    eventSchema = FileWatcherEventSchema;
+    actionSchema = FileWatcherActionSchema;
+    config;
+    watcher;
+    pendingEvents = [];
+    async initialize(config) {
+        this.config = config;
+        // Validate paths exist and are safe to watch
+        for (const watchPath of config.paths) {
+            // Security: Validate path is not in sensitive directory
+            validateSafePath(watchPath);
+            try {
+                await fs.access(watchPath);
+            }
+            catch {
+                throw new Error(`Watch path does not exist: ${watchPath}`);
+            }
+        }
+        // Initialize watcher
+        this.watcher = watch(config.paths, {
+            ignored: config.ignorePatterns,
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 500,
+                pollInterval: config.pollInterval,
+            },
+        });
+        // Set up event listeners
+        this.watcher
+            .on('add', (filePath) => this.handleEvent('added', filePath))
+            .on('change', (filePath) => this.handleEvent('changed', filePath))
+            .on('unlink', (filePath) => this.handleEvent('removed', filePath));
+    }
+    async handleEvent(type, filePath) {
+        // Check if matches patterns
+        if (!this.matchesPatterns(filePath)) {
+            return;
+        }
+        let size;
+        if (type !== 'removed') {
+            try {
+                const stats = await fs.stat(filePath);
+                size = stats.size;
+            }
+            catch {
+                // File might have been deleted between event and stat
+            }
+        }
+        this.pendingEvents.push({
+            type,
+            path: filePath,
+            timestamp: new Date().toISOString(),
+            size,
+        });
+    }
+    matchesPatterns(filePath) {
+        if (!this.config)
+            return false;
+        // Use micromatch for efficient and accurate glob pattern matching
+        return micromatch.isMatch(filePath, this.config.patterns);
+    }
+    async listen() {
+        const events = [...this.pendingEvents];
+        this.pendingEvents = [];
+        return events;
+    }
+    async execute(action) {
+        switch (action.type) {
+            case 'clear':
+                this.pendingEvents = [];
+                break;
+            case 'refresh':
+                // Force re-scan (optional enhancement)
+                break;
+        }
+    }
+    async updateConfig(updates) {
+        if (!this.config) {
+            throw new Error('Plugin not initialized');
+        }
+        const newConfig = { ...this.config, ...updates };
+        // Re-initialize with new config
+        await this.shutdown();
+        await this.initialize(newConfig);
+        return newConfig;
+    }
+    getConfig() {
+        if (!this.config) {
+            throw new Error('Plugin not initialized');
+        }
+        return { ...this.config };
+    }
+    async healthCheck() {
+        if (!this.watcher) {
+            return {
+                healthy: false,
+                message: 'Watcher not initialized',
+            };
+        }
+        // Check if watched paths still exist
+        const pathsExist = await Promise.all((this.config?.paths || []).map(async (p) => {
+            try {
+                await fs.access(p);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        }));
+        const allPathsExist = pathsExist.every(exists => exists);
+        return {
+            healthy: allPathsExist,
+            message: allPathsExist ? 'All watched paths accessible' : 'Some watched paths missing',
+            metadata: {
+                watchedPaths: this.config?.paths,
+                pendingEvents: this.pendingEvents.length,
+            },
+        };
+    }
+    async shutdown() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = undefined;
+        }
+        this.pendingEvents = [];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/plugins/implementations/file-watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/implementations/file-watcher/index.ts"],"names":[],"mappings":"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"}

package/dist/plugins/implementations/github/index.d.ts

@@ -0,0 +1,201 @@
+import { z } from 'zod';
+import { Plugin, PluginHealthStatus } from '../../types.js';
+export declare const GitHubConfigSchema: z.ZodObject<{
+    token: z.ZodString;
+    owner: z.ZodString;
+    repo: z.ZodString;
+    watchIssues: z.ZodDefault<z.ZodBoolean>;
+    watchPullRequests: z.ZodDefault<z.ZodBoolean>;
+    watchCommits: z.ZodDefault<z.ZodBoolean>;
+    pollIntervalMinutes: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+    owner: string;
+    repo: string;
+    watchIssues: boolean;
+    watchPullRequests: boolean;
+    watchCommits: boolean;
+    pollIntervalMinutes: number;
+}, {
+    token: string;
+    owner: string;
+    repo: string;
+    watchIssues?: boolean | undefined;
+    watchPullRequests?: boolean | undefined;
+    watchCommits?: boolean | undefined;
+    pollIntervalMinutes?: number | undefined;
+}>;
+export type GitHubConfig = z.infer<typeof GitHubConfigSchema>;
+export declare const GitHubEventSchema: z.ZodObject<{
+    type: z.ZodEnum<["issue", "pull_request", "commit", "comment"]>;
+    action: z.ZodEnum<["opened", "closed", "updated", "commented"]>;
+    number: z.ZodOptional<z.ZodNumber>;
+    sha: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    author: z.ZodString;
+    url: z.ZodString;
+    timestamp: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "issue" | "pull_request" | "commit" | "comment";
+    timestamp: string;
+    action: "opened" | "closed" | "updated" | "commented";
+    author: string;
+    url: string;
+    number?: number | undefined;
+    sha?: string | undefined;
+    title?: string | undefined;
+    body?: string | undefined;
+}, {
+    type: "issue" | "pull_request" | "commit" | "comment";
+    timestamp: string;
+    action: "opened" | "closed" | "updated" | "commented";
+    author: string;
+    url: string;
+    number?: number | undefined;
+    sha?: string | undefined;
+    title?: string | undefined;
+    body?: string | undefined;
+}>;
+export type GitHubEvent = z.infer<typeof GitHubEventSchema>;
+export declare const GitHubActionSchema: z.ZodObject<{
+    type: z.ZodEnum<["create-issue", "comment-issue", "close-issue", "create-pr", "comment-pr", "merge-pr", "add-label"]>;
+    issueNumber: z.ZodOptional<z.ZodNumber>;
+    prNumber: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    comment: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    head: z.ZodOptional<z.ZodString>;
+    base: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "create-issue" | "comment-issue" | "close-issue" | "create-pr" | "comment-pr" | "merge-pr" | "add-label";
+    comment?: string | undefined;
+    title?: string | undefined;
+    body?: string | undefined;
+    issueNumber?: number | undefined;
+    prNumber?: number | undefined;
+    labels?: string[] | undefined;
+    head?: string | undefined;
+    base?: string | undefined;
+}, {
+    type: "create-issue" | "comment-issue" | "close-issue" | "create-pr" | "comment-pr" | "merge-pr" | "add-label";
+    comment?: string | undefined;
+    title?: string | undefined;
+    body?: string | undefined;
+    issueNumber?: number | undefined;
+    prNumber?: number | undefined;
+    labels?: string[] | undefined;
+    head?: string | undefined;
+    base?: string | undefined;
+}>;
+export type GitHubAction = z.infer<typeof GitHubActionSchema>;
+/**
+ * GitHub Integration Plugin
+ *
+ * Enables navigators to monitor and interact with GitHub repositories.
+ * Supports issues, pull requests, commits, and comments.
+ */
+export declare class GitHubPlugin implements Plugin<GitHubConfig, GitHubEvent, GitHubAction> {
+    readonly name = "github";
+    readonly version = "1.0.0";
+    readonly description = "Monitor and interact with GitHub repositories";
+    readonly configSchema: z.ZodObject<{
+        token: z.ZodString;
+        owner: z.ZodString;
+        repo: z.ZodString;
+        watchIssues: z.ZodDefault<z.ZodBoolean>;
+        watchPullRequests: z.ZodDefault<z.ZodBoolean>;
+        watchCommits: z.ZodDefault<z.ZodBoolean>;
+        pollIntervalMinutes: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        token: string;
+        owner: string;
+        repo: string;
+        watchIssues: boolean;
+        watchPullRequests: boolean;
+        watchCommits: boolean;
+        pollIntervalMinutes: number;
+    }, {
+        token: string;
+        owner: string;
+        repo: string;
+        watchIssues?: boolean | undefined;
+        watchPullRequests?: boolean | undefined;
+        watchCommits?: boolean | undefined;
+        pollIntervalMinutes?: number | undefined;
+    }>;
+    readonly eventSchema: z.ZodObject<{
+        type: z.ZodEnum<["issue", "pull_request", "commit", "comment"]>;
+        action: z.ZodEnum<["opened", "closed", "updated", "commented"]>;
+        number: z.ZodOptional<z.ZodNumber>;
+        sha: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+        author: z.ZodString;
+        url: z.ZodString;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "issue" | "pull_request" | "commit" | "comment";
+        timestamp: string;
+        action: "opened" | "closed" | "updated" | "commented";
+        author: string;
+        url: string;
+        number?: number | undefined;
+        sha?: string | undefined;
+        title?: string | undefined;
+        body?: string | undefined;
+    }, {
+        type: "issue" | "pull_request" | "commit" | "comment";
+        timestamp: string;
+        action: "opened" | "closed" | "updated" | "commented";
+        author: string;
+        url: string;
+        number?: number | undefined;
+        sha?: string | undefined;
+        title?: string | undefined;
+        body?: string | undefined;
+    }>;
+    readonly actionSchema: z.ZodObject<{
+        type: z.ZodEnum<["create-issue", "comment-issue", "close-issue", "create-pr", "comment-pr", "merge-pr", "add-label"]>;
+        issueNumber: z.ZodOptional<z.ZodNumber>;
+        prNumber: z.ZodOptional<z.ZodNumber>;
+        title: z.ZodOptional<z.ZodString>;
+        body: z.ZodOptional<z.ZodString>;
+        comment: z.ZodOptional<z.ZodString>;
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        head: z.ZodOptional<z.ZodString>;
+        base: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "create-issue" | "comment-issue" | "close-issue" | "create-pr" | "comment-pr" | "merge-pr" | "add-label";
+        comment?: string | undefined;
+        title?: string | undefined;
+        body?: string | undefined;
+        issueNumber?: number | undefined;
+        prNumber?: number | undefined;
+        labels?: string[] | undefined;
+        head?: string | undefined;
+        base?: string | undefined;
+    }, {
+        type: "create-issue" | "comment-issue" | "close-issue" | "create-pr" | "comment-pr" | "merge-pr" | "add-label";
+        comment?: string | undefined;
+        title?: string | undefined;
+        body?: string | undefined;
+        issueNumber?: number | undefined;
+        prNumber?: number | undefined;
+        labels?: string[] | undefined;
+        head?: string | undefined;
+        base?: string | undefined;
+    }>;
+    private config?;
+    private octokit?;
+    private lastCheckTime;
+    initialize(config: GitHubConfig): Promise<void>;
+    listen(): Promise<GitHubEvent[]>;
+    execute(action: GitHubAction): Promise<unknown>;
+    updateConfig(updates: Partial<GitHubConfig>): Promise<GitHubConfig>;
+    getConfig(): GitHubConfig;
+    healthCheck(): Promise<PluginHealthStatus>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/implementations/github/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/implementations/github/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAK5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;EAQ7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAG9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAG5D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,YAAa,YAAW,MAAM,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC;IAClF,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,mDAAmD;IACvE,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;OAAsB;IAC3C,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAqB;IACzC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAAsB;IAE3C,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,aAAa,CAAqB;IAEpC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB/C,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAuGhC,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC;IAsI/C,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAsBzE,SAAS,IAAI,YAAY;IAOnB,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAiC1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}