@renseiai/agentfactory 0.8.12 → 0.8.13

package/dist/src/merge-queue/strategies/types.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Merge Strategy Types
+ *
+ * Pluggable interface for merge strategies (rebase, merge, squash).
+ * Each strategy encapsulates how a PR branch is integrated into the target branch.
+ */
+/** Context passed to every merge strategy operation */
+export interface MergeContext {
+    /** Path to the bare repository */
+    repoPath: string;
+    /** Path to the worktree used for merge operations */
+    worktreePath: string;
+    /** Branch being merged (PR branch) */
+    sourceBranch: string;
+    /** Branch being merged into (e.g. main) */
+    targetBranch: string;
+    /** Pull request number */
+    prNumber: number;
+    /** Git remote name (default 'origin') */
+    remote: string;
+}
+/** Result of the prepare step */
+export interface PrepareResult {
+    /** Whether preparation succeeded */
+    success: boolean;
+    /** Error message if preparation failed */
+    error?: string;
+    /** HEAD SHA after preparation */
+    headSha?: string;
+}
+/** Result of the execute (merge) step */
+export interface MergeResult {
+    /** Outcome of the merge attempt */
+    status: 'success' | 'conflict' | 'error';
+    /** SHA of the merge result commit */
+    mergedSha?: string;
+    /** List of files with conflicts (when status is 'conflict') */
+    conflictFiles?: string[];
+    /** Human-readable conflict details */
+    conflictDetails?: string;
+    /** Error message (when status is 'error') */
+    error?: string;
+}
+/**
+ * Pluggable merge strategy interface.
+ *
+ * Lifecycle:
+ *   1. prepare() — fetch latest refs and check out the working branch
+ *   2. execute() — perform the merge/rebase/squash operation
+ *   3. finalize() — push the result to the remote
+ */
+export interface MergeStrategy {
+    /** Strategy identifier */
+    readonly name: 'rebase' | 'merge' | 'squash';
+    /** Fetch latest refs and check out the working branch */
+    prepare(ctx: MergeContext): Promise<PrepareResult>;
+    /** Perform the merge operation */
+    execute(ctx: MergeContext): Promise<MergeResult>;
+    /** Push the result to the remote */
+    finalize(ctx: MergeContext): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/merge-queue/strategies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/merge-queue/strategies/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAA;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,YAAY,EAAE,MAAM,CAAA;IACpB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,iCAAiC;AACjC,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;IACxC,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;IAC5C,yDAAyD;IACzD,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAClD,kCAAkC;IAClC,OAAO,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAChD,oCAAoC;IACpC,QAAQ,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3C"}

package/dist/src/merge-queue/strategies/types.js

@@ -0,0 +1,7 @@
+/**
+ * Merge Strategy Types
+ *
+ * Pluggable interface for merge strategies (rebase, merge, squash).
+ * Each strategy encapsulates how a PR branch is integrated into the target branch.
+ */
+export {};

package/dist/src/orchestrator/parse-work-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse-work-result.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/parse-work-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA6GjD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,aAAa,GACtB,eAAe,CAyCjB"}
+{"version":3,"file":"parse-work-result.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/parse-work-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA6HjD;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,aAAa,GACtB,eAAe,CAkDjB"}

package/dist/src/orchestrator/parse-work-result.js

@@ -81,6 +81,20 @@ const COORDINATION_PASS_PATTERNS = [
     // "Parent issue marked Finished" — coordinator confirms parent status update
     /\bParent\s+issue\s+marked\s+Finished/i,
 ];
+const MERGE_PASS_PATTERNS = [
+    /merge.*completed/i,
+    /successfully\s+merged/i,
+    /fast-forward\s+merge/i,
+    /merged\s+to\s+main/i,
+    /merge\s+queue.*completed/i,
+];
+const MERGE_FAIL_PATTERNS = [
+    /merge.*failed/i,
+    /merge\s+conflict/i,
+    /could\s+not\s+merge/i,
+    /rebase.*failed/i,
+    /test.*failed.*after.*rebase/i,
+];
 const COORDINATION_FAIL_PATTERNS = [
     // "Must Fix Before Merge" — agents use this heading for blocking issues
     /\bMust\s+Fix\s+Before\s+Merge\b/i,
@@ -144,6 +158,14 @@ export function parseWorkResult(resultMessage, workType) {
             return 'passed';
         }
     }
+    if (workType === 'merge') {
+        if (MERGE_FAIL_PATTERNS.some((p) => p.test(resultMessage))) {
+            return 'failed';
+        }
+        if (MERGE_PASS_PATTERNS.some((p) => p.test(resultMessage))) {
+            return 'passed';
+        }
+    }
     // 3. Unknown — safe default
     return 'unknown';
 }

package/dist/src/orchestrator/parse-work-result.test.js

@@ -233,6 +233,55 @@ describe('parseWorkResult', () => {
             expect(parseWorkResult('### 3 Critical Issues (Block Merge)\n1. provision-trial.ts uses removed fields', 'acceptance-coordination')).toBe('failed');
         });
     });
+    // Merge heuristic pattern tests
+    describe('merge heuristic patterns', () => {
+        it('detects WORK_RESULT:passed marker for merge work type', () => {
+            expect(parseWorkResult('<!-- WORK_RESULT:passed -->', 'merge')).toBe('passed');
+        });
+        it('detects WORK_RESULT:failed marker for merge work type', () => {
+            expect(parseWorkResult('<!-- WORK_RESULT:failed -->', 'merge')).toBe('failed');
+        });
+        it('detects "successfully merged" as pass', () => {
+            expect(parseWorkResult('The PR was successfully merged to main.', 'merge')).toBe('passed');
+        });
+        it('detects "merge completed" as pass', () => {
+            expect(parseWorkResult('Merge completed without issues.', 'merge')).toBe('passed');
+        });
+        it('detects "fast-forward merge" as pass', () => {
+            expect(parseWorkResult('Applied fast-forward merge to the branch.', 'merge')).toBe('passed');
+        });
+        it('detects "merged to main" as pass', () => {
+            expect(parseWorkResult('PR #42 merged to main successfully.', 'merge')).toBe('passed');
+        });
+        it('detects "merge queue completed" as pass', () => {
+            expect(parseWorkResult('Merge queue completed for this PR.', 'merge')).toBe('passed');
+        });
+        it('detects "merge conflict" as fail', () => {
+            expect(parseWorkResult('Encountered a merge conflict in src/index.ts.', 'merge')).toBe('failed');
+        });
+        it('detects "merge failed" as fail', () => {
+            expect(parseWorkResult('The merge failed due to CI check failures.', 'merge')).toBe('failed');
+        });
+        it('detects "could not merge" as fail', () => {
+            expect(parseWorkResult('Could not merge the PR — conflicts detected.', 'merge')).toBe('failed');
+        });
+        it('detects "rebase failed" as fail', () => {
+            expect(parseWorkResult('Rebase failed on commit abc123.', 'merge')).toBe('failed');
+        });
+        it('detects "test failed after rebase" as fail', () => {
+            expect(parseWorkResult('The test suite failed after rebase on main.', 'merge')).toBe('failed');
+        });
+        it('checks fail patterns before pass patterns', () => {
+            expect(parseWorkResult('Merge completed but then merge failed on retry.', 'merge')).toBe('failed');
+        });
+        it('does not match merge patterns for non-merge work types', () => {
+            expect(parseWorkResult('successfully merged', 'development')).toBe('unknown');
+            expect(parseWorkResult('merge conflict', 'qa')).toBe('unknown');
+        });
+        it('returns unknown for ambiguous merge messages', () => {
+            expect(parseWorkResult('Working on the merge process.', 'merge')).toBe('unknown');
+        });
+    });
     // Unknown result tests
     describe('unknown results', () => {
         it('returns unknown for undefined message', () => {

package/dist/src/providers/index.d.ts

@@ -29,6 +29,7 @@
  */
 export type { AgentProviderName, AgentProvider, AgentSpawnConfig, AgentHandle, AgentEvent } from './types.js';
 export type { AgentInitEvent, AgentSystemEvent, AgentAssistantTextEvent, AgentToolUseEvent, AgentToolResultEvent, AgentToolProgressEvent, AgentResultEvent, AgentErrorEvent, AgentCostData, } from './types.js';
+export type { ActionDefinition, ActionResult, AuthResult, ConditionContext, ConditionDefinition, CredentialDefinition, CredentialField, DynamicOptionField, NormalizedEvent, ProviderExecutionContext, ProviderPlugin, TriggerDefinition, WebhookConfig, WebhookRegistration, } from './plugin-types.js';
 export { ClaudeProvider, createClaudeProvider } from './claude-provider.js';
 export { CodexProvider, createCodexProvider } from './codex-provider.js';
 export { AmpProvider, createAmpProvider } from './amp-provider.js';

package/dist/src/providers/index.d.ts.map

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

package/dist/src/providers/plugin-types.d.ts

@@ -0,0 +1,177 @@
+/**
+ * Provider Plugin Interfaces
+ *
+ * Defines the core type system for provider plugins — integrations that
+ * expose actions, triggers, and conditions (e.g. Slack, GitHub, Jira).
+ *
+ * This is SEPARATE from AgentProvider (types.ts), which handles agent
+ * process management. ProviderPlugin handles integration capabilities.
+ */
+import type { JSONSchema7 } from 'json-schema';
+/** A single credential field required by a provider's authentication */
+export interface CredentialField {
+    /** Machine-readable field name */
+    name: string;
+    /** Human-readable label */
+    label: string;
+    /** Input type hint for credential UIs */
+    type: 'string' | 'url' | 'password';
+    /** Whether this field contains a secret value */
+    secret?: boolean;
+    /** Help text describing the field */
+    description?: string;
+}
+/** Result of validating provider credentials */
+export interface AuthResult {
+    /** Whether authentication succeeded */
+    valid: boolean;
+    /** Error message when authentication fails */
+    error?: string;
+    /** Additional metadata returned by the auth check */
+    metadata?: Record<string, unknown>;
+}
+/** Describes a field whose options are resolved at runtime */
+export interface DynamicOptionField {
+    /** Dot-path to the field within the input schema */
+    fieldPath: string;
+    /** Other field paths whose values must be resolved first */
+    dependsOn?: string[];
+}
+/** Runtime context passed to action and trigger executors */
+export interface ProviderExecutionContext {
+    /** Resolved credential values for the provider */
+    credentials: Record<string, string>;
+    /** Optional environment variables */
+    env?: Record<string, string>;
+}
+/** Result returned by an action execution */
+export interface ActionResult {
+    /** Whether the action completed successfully */
+    success: boolean;
+    /** Payload returned by the action on success */
+    data?: unknown;
+    /** Error message when the action fails */
+    error?: string;
+}
+/** A provider event normalized to a common shape */
+export interface NormalizedEvent {
+    /** Unique event identifier */
+    id: string;
+    /** Event type (e.g. 'issue.created', 'message.posted') */
+    type: string;
+    /** When the event occurred */
+    timestamp: Date;
+    /** Structured event payload */
+    data: Record<string, unknown>;
+    /** Original un-normalized event from the provider */
+    raw: unknown;
+}
+/** Configuration for registering a webhook with a provider */
+export interface WebhookConfig {
+    /** The URL the provider should deliver events to */
+    url: string;
+    /** Shared secret for verifying webhook payloads */
+    secret?: string;
+    /** Event types to subscribe to */
+    events?: string[];
+}
+/** Handle returned after a webhook is registered */
+export interface WebhookRegistration {
+    /** Provider-assigned webhook identifier */
+    id: string;
+    /** The registered webhook URL */
+    url: string;
+    /** Provider-specific registration metadata */
+    metadata?: Record<string, unknown>;
+}
+/** Context available when evaluating a condition */
+export interface ConditionContext {
+    /** The trigger event that initiated the workflow, if any */
+    triggerEvent?: NormalizedEvent;
+    /** Outputs from previous workflow steps, keyed by step id */
+    stepOutputs?: Record<string, unknown>;
+}
+/** Defines how a provider authenticates (OAuth2, API key, bearer token) */
+export interface CredentialDefinition {
+    /** Unique credential identifier within the provider */
+    id: string;
+    /** Authentication strategy */
+    authType: 'oauth2' | 'apiKey' | 'bearer';
+    /** Fields the user must supply */
+    requiredFields: CredentialField[];
+    /** Validate the supplied credentials against the provider */
+    authenticate(credentials: Record<string, string>): Promise<AuthResult>;
+}
+/** An operation that can be performed against a provider */
+export interface ActionDefinition {
+    /** Unique action identifier within the provider */
+    id: string;
+    /** Human-readable action name */
+    displayName: string;
+    /** Brief description of what the action does */
+    description?: string;
+    /** Grouping category for UI organization */
+    category?: string;
+    /** JSON Schema describing the action's input parameters */
+    inputSchema: JSONSchema7;
+    /** JSON Schema describing the action's output shape */
+    outputSchema: JSONSchema7;
+    /** Fields whose options are resolved dynamically at runtime */
+    dynamicOptions?: DynamicOptionField[];
+    /** Execute the action with the given input and credentials */
+    execute(input: Record<string, unknown>, context: ProviderExecutionContext): Promise<ActionResult>;
+}
+/** An event source that can initiate workflows */
+export interface TriggerDefinition {
+    /** Unique trigger identifier within the provider */
+    id: string;
+    /** Human-readable trigger name */
+    displayName: string;
+    /** Brief description of the trigger */
+    description?: string;
+    /** The type of event this trigger produces */
+    eventType: string;
+    /** JSON Schema for filtering which events match */
+    filterSchema: JSONSchema7;
+    /** Convert a raw provider event into a NormalizedEvent */
+    normalizeEvent(rawEvent: unknown): NormalizedEvent;
+    /** Register a webhook with the provider to receive events */
+    registerWebhook(config: WebhookConfig): Promise<WebhookRegistration>;
+    /** Remove a previously registered webhook */
+    deregisterWebhook(registration: WebhookRegistration): Promise<void>;
+}
+/** A boolean predicate used for conditional branching in workflows */
+export interface ConditionDefinition {
+    /** Unique condition identifier within the provider */
+    id: string;
+    /** Human-readable condition name */
+    displayName: string;
+    /** Brief description of the condition */
+    description?: string;
+    /** JSON Schema describing the evaluation parameters */
+    evaluationSchema: JSONSchema7;
+    /** Evaluate the condition against the given parameters and context */
+    evaluate(params: Record<string, unknown>, context: ConditionContext): Promise<boolean>;
+}
+/** A provider plugin that bundles actions, triggers, conditions, and credentials */
+export interface ProviderPlugin {
+    /** Unique provider identifier (e.g. 'slack', 'github', 'jira') */
+    id: string;
+    /** Human-readable provider name */
+    displayName: string;
+    /** Brief description of the provider */
+    description?: string;
+    /** Semantic version of the plugin */
+    version: string;
+    /** Icon identifier or URL for the provider */
+    icon?: string;
+    /** Actions this provider exposes */
+    actions: ActionDefinition[];
+    /** Triggers (event sources) this provider exposes */
+    triggers: TriggerDefinition[];
+    /** Conditions this provider exposes */
+    conditions: ConditionDefinition[];
+    /** Credential definitions for authenticating with this provider */
+    credentials: CredentialDefinition[];
+}
+//# sourceMappingURL=plugin-types.d.ts.map

package/dist/src/providers/plugin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.d.ts","sourceRoot":"","sources":["../../../src/providers/plugin-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAM9C,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,yCAAyC;IACzC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAA;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAA;IACd,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAA;IACjB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC7B;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAA;IAChB,gDAAgD;IAChD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;IACZ,8BAA8B;IAC9B,SAAS,EAAE,IAAI,CAAA;IACf,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,qDAAqD;IACrD,GAAG,EAAE,OAAO,CAAA;CACb;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAA;IACX,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,oDAAoD;AACpD,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAA;IACV,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,4DAA4D;IAC5D,YAAY,CAAC,EAAE,eAAe,CAAA;IAC9B,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC;AAMD,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAA;IACV,8BAA8B;IAC9B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACxC,kCAAkC;IAClC,cAAc,EAAE,eAAe,EAAE,CAAA;IACjC,6DAA6D;IAC7D,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CACvE;AAED,4DAA4D;AAC5D,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAA;IACV,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2DAA2D;IAC3D,WAAW,EAAE,WAAW,CAAA;IACxB,uDAAuD;IACvD,YAAY,EAAE,WAAW,CAAA;IACzB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACrC,8DAA8D;IAC9D,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CAClG;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAA;IACV,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,YAAY,EAAE,WAAW,CAAA;IACzB,0DAA0D;IAC1D,cAAc,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,CAAA;IAClD,6DAA6D;IAC7D,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACpE,6CAA6C;IAC7C,iBAAiB,CAAC,YAAY,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpE;AAED,sEAAsE;AACtE,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAA;IACV,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uDAAuD;IACvD,gBAAgB,EAAE,WAAW,CAAA;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvF;AAED,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAA;IACV,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,qDAAqD;IACrD,QAAQ,EAAE,iBAAiB,EAAE,CAAA;IAC7B,uCAAuC;IACvC,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,mEAAmE;IACnE,WAAW,EAAE,oBAAoB,EAAE,CAAA;CACpC"}

package/dist/src/providers/plugin-types.js

@@ -0,0 +1,10 @@
+/**
+ * Provider Plugin Interfaces
+ *
+ * Defines the core type system for provider plugins — integrations that
+ * expose actions, triggers, and conditions (e.g. Slack, GitHub, Jira).
+ *
+ * This is SEPARATE from AgentProvider (types.ts), which handles agent
+ * process management. ProviderPlugin handles integration capabilities.
+ */
+export {};

package/dist/src/providers/plugin-types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-types.test.d.ts.map

package/dist/src/providers/plugin-types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-types.test.d.ts","sourceRoot":"","sources":["../../../src/providers/plugin-types.test.ts"],"names":[],"mappings":""}