@probelabs/visor 0.1.106 → 0.1.111

package/dist/examples/workflows/code-quality.yaml

@@ -0,0 +1,222 @@
+# Example reusable workflow for code quality checks
+id: code-quality
+name: Code Quality Workflow
+description: Comprehensive code quality checks including linting, complexity, and best practices
+version: "1.0.0"
+tags: ["quality", "reusable", "linting"]
+category: quality
+
+# Input parameters
+inputs:
+  - name: language
+    description: Programming language to analyze
+    schema:
+      type: string
+      enum: ["javascript", "typescript", "python", "go", "java"]
+    required: true
+
+  - name: complexity_threshold
+    description: Maximum allowed cyclomatic complexity
+    schema:
+      type: number
+      minimum: 1
+      maximum: 20
+    default: 10
+
+  - name: enable_formatting
+    description: Check code formatting
+    schema:
+      type: boolean
+    default: true
+
+  - name: custom_rules
+    description: Custom linting rules to apply
+    schema:
+      type: object
+      additionalProperties: true
+    required: false
+
+# Output parameters
+outputs:
+  - name: quality_score
+    description: Overall code quality score (0-100)
+    value_js: |
+      const lintScore = steps.linting?.output?.score || 0;
+      const complexityScore = steps.complexity?.output?.score || 0;
+      const formattingScore = steps.formatting?.output?.score || 100;
+      const weights = { lint: 0.4, complexity: 0.4, formatting: 0.2 };
+      return Math.round(
+        lintScore * weights.lint +
+        complexityScore * weights.complexity +
+        formattingScore * weights.formatting
+      );
+
+  - name: recommendations
+    description: List of recommendations for improvement
+    value_js: |
+      const recs = [];
+      if (steps.linting?.output?.issues?.length > 0) {
+        recs.push(`Fix ${steps.linting.output.issues.length} linting issues`);
+      }
+      if (steps.complexity?.output?.high_complexity_functions?.length > 0) {
+        recs.push(`Refactor ${steps.complexity.output.high_complexity_functions.length} complex functions`);
+      }
+      if (steps.formatting?.output?.issues?.length > 0) {
+        recs.push(`Fix ${steps.formatting.output.issues.length} formatting issues`);
+      }
+      return recs;
+
+  - name: detailed_report
+    description: Detailed quality report
+    value: |
+      Code Quality Report for {{ inputs.language }}:
+      ================================================
+      Overall Score: {{ outputs.quality_score }}/100
+
+      Linting Results:
+      - Issues found: {{ steps.linting.output.issues | size }}
+      - Score: {{ steps.linting.output.score }}/100
+
+      Complexity Analysis:
+      - High complexity functions: {{ steps.complexity.output.high_complexity_functions | size }}
+      - Average complexity: {{ steps.complexity.output.average_complexity }}
+
+      {% if inputs.enable_formatting %}
+      Formatting Check:
+      - Issues found: {{ steps.formatting.output.issues | size }}
+      - Score: {{ steps.formatting.output.score }}/100
+      {% endif %}
+
+      Recommendations:
+      {% for rec in outputs.recommendations %}
+      - {{ rec }}
+      {% endfor %}
+
+# Workflow steps
+steps:
+  linting:
+    type: ai
+    prompt: |
+      Perform linting analysis for {{ inputs.language }} code.
+      Check for:
+      - Syntax errors
+      - Code style violations
+      - Best practices violations
+      - Unused variables and imports
+      - Type errors (if applicable)
+
+      {% if inputs.custom_rules %}
+      Additional custom rules to check:
+      {{ inputs.custom_rules | json }}
+      {% endif %}
+
+      Provide a score from 0-100 based on the issues found.
+    focus: style
+    schema: code-review
+    inputs:
+      language:
+        source: param
+        value: language
+      custom_rules:
+        source: param
+        value: custom_rules
+
+  complexity:
+    type: ai
+    prompt: |
+      Analyze code complexity for {{ inputs.language }}.
+
+      Check for:
+      - Cyclomatic complexity (threshold: {{ inputs.complexity_threshold }})
+      - Cognitive complexity
+      - Nested conditionals
+      - Long functions/methods
+      - Too many parameters
+
+      Report:
+      - List of functions exceeding complexity threshold
+      - Average complexity across the codebase
+      - Provide a score from 0-100
+    focus: architecture
+    schema: code-review
+    depends_on: [linting]
+    inputs:
+      language:
+        source: param
+        value: language
+      complexity_threshold:
+        source: param
+        value: complexity_threshold
+
+  formatting:
+    type: command
+    exec: |
+      case "{{ inputs.language }}" in
+        javascript|typescript)
+          npx prettier --check "**/*.{js,ts,jsx,tsx}" --list-different || true
+          ;;
+        python)
+          python -m black --check . --diff || true
+          ;;
+        go)
+          gofmt -l . || true
+          ;;
+        java)
+          echo "Java formatting check not implemented"
+          ;;
+      esac
+    if: inputs.enable_formatting === true
+    depends_on: [complexity]
+    inputs:
+      language:
+        source: param
+        value: language
+      enable_formatting:
+        source: param
+        value: enable_formatting
+
+  best_practices:
+    type: ai
+    prompt: |
+      Review {{ inputs.language }} code for best practices:
+
+      - Design patterns usage
+      - SOLID principles adherence
+      - Error handling patterns
+      - Documentation quality
+      - Test coverage indicators
+      - Performance considerations
+
+      Provide actionable recommendations.
+    focus: architecture
+    depends_on: [formatting]
+    inputs:
+      language:
+        source: param
+        value: language
+
+  aggregate_results:
+    type: noop
+    depends_on: [best_practices]
+    # This step exists to ensure all previous steps complete
+    # The actual aggregation happens in the output parameters
+
+# Usage examples (documentation only):
+#
+# 1. TypeScript with strict settings:
+#    language: typescript
+#    complexity_threshold: 8
+#    enable_formatting: true
+#    custom_rules:
+#      no-any: error
+#      explicit-function-return-type: warning
+#
+# 2. Python basic check:
+#    language: python
+#    complexity_threshold: 15
+#    enable_formatting: false
+#
+# 3. Go with formatting:
+#    language: go
+#    complexity_threshold: 10
+#    enable_formatting: true

package/dist/examples/workflows/quick-pr-check.yaml

@@ -0,0 +1,90 @@
+# Quick PR validation workflow
+# Performs basic checks for PR validation
+
+id: quick-pr-check
+name: Quick PR Check
+description: Fast workflow for initial PR validation
+version: "1.0.0"
+category: validation
+
+# Input parameters
+inputs:
+  - name: pr_type
+    description: Type of PR (feature, bugfix, hotfix)
+    schema:
+      type: string
+      enum: ["feature", "bugfix", "hotfix"]
+    required: true
+
+  - name: run_tests
+    description: Whether to run tests
+    schema:
+      type: boolean
+    default: true
+
+  - name: run_lint
+    description: Whether to run linting
+    schema:
+      type: boolean
+    default: true
+
+# Output parameters
+outputs:
+  - name: approval_status
+    description: Whether the PR passes quick checks
+    value_js: |
+      const testsPassed = !inputs.run_tests || steps.run_tests?.output?.success || false;
+      const lintPassed = !inputs.run_lint || steps.lint_check?.output?.passed || false;
+      return testsPassed && lintPassed ? "approved" : "needs_work";
+
+  - name: summary
+    description: Summary of the quick check
+    value: |
+      Quick Check Results for {{ inputs.pr_type }} PR:
+      {% if inputs.run_tests %}
+      - Tests: {{ steps.run_tests.output.success ? 'Passed' : 'Failed' }}
+      {% endif %}
+      {% if inputs.run_lint %}
+      - Linting: {{ steps.lint_check.output.passed ? 'Passed' : 'Failed' }}
+      {% endif %}
+      Overall Status: {{ outputs.approval_status }}
+
+# Workflow steps at root level
+steps:
+  run_tests:
+    type: command
+    exec: npm test
+    timeout: 300
+    if: inputs.run_tests === true
+
+  lint_check:
+    type: command
+    exec: npm run lint
+    depends_on: [run_tests]
+    if: inputs.run_lint === true
+
+  pr_summary:
+    type: log
+    message: |
+      Quick Check Results for {{ inputs.pr_type }} PR:
+      {% if inputs.run_tests %}
+      - Tests: {{ steps.run_tests.output.success ? 'Passed' : 'Failed' }}
+      {% endif %}
+      {% if inputs.run_lint %}
+      - Linting: {{ steps.lint_check.output.passed ? 'Passed' : 'Failed' }}
+      {% endif %}
+      Status: {{ outputs.approval_status }}
+    depends_on: [lint_check]
+    level: info
+
+# Usage examples (documentation only):
+#
+# 1. Full validation:
+#    pr_type: feature
+#    run_tests: true
+#    run_lint: true
+#
+# 2. Quick lint only:
+#    pr_type: hotfix
+#    run_tests: false
+#    run_lint: true

package/dist/examples/workflows/workflow-composition-example.yaml

@@ -0,0 +1,130 @@
+# Example demonstrating workflow composition and state isolation
+# This config imports the calculator workflow and uses it as a step
+# Demonstrates that:
+# 1. Workflow tests are NOT auto-executed when imported
+# 2. Workflow steps run in isolated context
+# 3. State does not leak between workflow and parent config
+
+version: "1.0"
+
+# Import the calculator workflow
+imports:
+  - ./calculator-workflow.yaml
+
+# Main checks/steps in this config
+checks:
+  # Step 1: Set some state in parent context
+  parent_state_setup:
+    type: memory
+    operation: set
+    key: parent_value
+    value: "I am from parent context"
+
+  # Step 2: Use the calculator workflow as an isolated step
+  use_calculator:
+    type: workflow
+    workflow: calculator
+    depends_on: [parent_state_setup]
+    args:
+      operation: multiply
+      a: 7
+      b: 6
+
+  # Step 3: Verify calculator result is accessible
+  verify_calculator_result:
+    type: command
+    depends_on: [use_calculator]
+    exec: |
+      #!/bin/bash
+      result="{{ outputs.use_calculator.result }}"
+      summary="{{ outputs.use_calculator.summary }}"
+
+      echo "Calculator returned: $result"
+      echo "Summary: $summary"
+
+      if [ "$result" = "42" ]; then
+        echo '{"validation": "passed", "result": '$result'}'
+        exit 0
+      else
+        echo '{"validation": "failed", "expected": 42, "got": '$result'}'
+        exit 1
+      fi
+
+  # Step 4: Verify parent state is still intact (not affected by workflow)
+  verify_parent_state:
+    type: memory
+    operation: get
+    key: parent_value
+    depends_on: [use_calculator]
+
+  # Step 5: Test state isolation - workflow should NOT have access to parent memory
+  test_state_isolation:
+    type: command
+    depends_on: [verify_parent_state]
+    exec: |
+      #!/bin/bash
+      parent_value="{{ outputs.verify_parent_state }}"
+
+      echo "Parent state verification:"
+      echo "  parent_value = $parent_value"
+
+      if [ "$parent_value" = "I am from parent context" ]; then
+        echo '{"isolation_test": "passed", "message": "Parent state intact"}'
+        exit 0
+      else
+        echo '{"isolation_test": "failed", "message": "Parent state was modified"}'
+        exit 1
+      fi
+
+  # Step 6: Use calculator again with different inputs (reusability test)
+  use_calculator_again:
+    type: workflow
+    workflow: calculator
+    depends_on: [test_state_isolation]
+    args:
+      operation: add
+      a: 100
+      b: 23
+
+  # Step 7: Verify both calculator invocations produced correct results
+  verify_multiple_invocations:
+    type: command
+    depends_on: [use_calculator_again]
+    exec: |
+      #!/bin/bash
+      first_result="{{ outputs.use_calculator.result }}"
+      second_result="{{ outputs.use_calculator_again.result }}"
+
+      echo "Multiple invocation test:"
+      echo "  First call (7 * 6): $first_result (expected 42)"
+      echo "  Second call (100 + 23): $second_result (expected 123)"
+
+      if [ "$first_result" = "42" ] && [ "$second_result" = "123" ]; then
+        echo '{"multiple_invocations": "passed"}'
+        exit 0
+      else
+        echo '{"multiple_invocations": "failed"}'
+        exit 1
+      fi
+
+  # Final summary
+  summary:
+    type: log
+    depends_on: [verify_multiple_invocations]
+    message: |
+      ========================================
+      Workflow Composition Test Summary
+      ========================================
+
+      ✓ Calculator workflow imported successfully
+      ✓ Workflow tests were NOT auto-executed
+      ✓ Calculator step executed in isolation
+      ✓ Results: {{ outputs.use_calculator.summary }}
+      ✓ Parent state remained intact
+      ✓ Multiple workflow invocations work correctly
+
+      First calculation: {{ outputs.use_calculator.result }}
+      Second calculation: {{ outputs.use_calculator_again.result }}
+
+      All state isolation tests PASSED!
+      ========================================

package/dist/failure-condition-evaluator.d.ts

@@ -36,6 +36,9 @@ export declare class FailureConditionEvaluator {
         environment?: Record<string, string>;
         previousResults?: Map<string, ReviewSummary>;
         authorAssociation?: string;
+        workflowInputs?: Record<string, unknown>;
+        /** Current step's output for guarantee evaluation */
+        output?: unknown;
     }): Promise<boolean>;
     /**
      * Evaluate all failure conditions for a check result

package/dist/failure-condition-evaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"","sourceRoot":"","sources":["file:///home/runner/work/visor/visor/src/failure-condition-evaluator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EACL,iBAAiB,EAGjB,sBAAsB,EAEvB,MAAM,gBAAgB,CAAC;AAMxB;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAU;;IAI1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACG,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC/C,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,OAAO,CAAC;IA2DnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GACA,OAAO,CAAC,OAAO,CAAC;IAoEnB;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,EAC5B,gBAAgB,CAAC,EAAE,iBAAiB,EACpC,eAAe,CAAC,EAAE,iBAAiB,EACnC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC/C,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,sBAAsB,EAAE,CAAC;IA4CpC;;OAEG;YACW,oBAAoB;IA0ElC;;OAEG;YACW,uBAAuB;IA0BrC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAyN1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkK9B,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,OAAO;IAItE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,sBAAsB,EAAE;IAIvF;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG;QAChE,KAAK,EAAE,sBAAsB,EAAE,CAAC;QAChC,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAClC,IAAI,EAAE,sBAAsB,EAAE,CAAC;KAChC;IASD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,MAAM;CAiChE"}
+{"version":3,"file":"","sourceRoot":"","sources":["file:///home/runner/work/visor/visor/src/failure-condition-evaluator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EACL,iBAAiB,EAGjB,sBAAsB,EAEvB,MAAM,gBAAgB,CAAC;AAMxB;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAC,CAAU;;IAI1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACG,uBAAuB,CAC3B,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC/C,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,OAAO,CAAC;IA2DnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACG,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,qDAAqD;QACrD,MAAM,CAAC,EAAE,OAAO,CAAC;KAClB,GACA,OAAO,CAAC,OAAO,CAAC;IAoFnB;;OAEG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,EAC5B,gBAAgB,CAAC,EAAE,iBAAiB,EACpC,eAAe,CAAC,EAAE,iBAAiB,EACnC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAC/C,iBAAiB,CAAC,EAAE,MAAM,GACzB,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAmCpC;;OAEG;YACW,oBAAoB;IA0ElC;;OAEG;YACW,uBAAuB;IA0BrC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA6S1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAkK9B,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,OAAO;IAItE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,sBAAsB,EAAE;IAIvF;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG;QAChE,KAAK,EAAE,sBAAsB,EAAE,CAAC;QAChC,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAClC,IAAI,EAAE,sBAAsB,EAAE,CAAC;KAChC;IASD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,MAAM;CAiChE"}

package/dist/frontends/github-frontend.d.ts

@@ -0,0 +1,58 @@
+import type { Frontend, FrontendContext } from './host';
+export declare class GitHubFrontend implements Frontend {
+    readonly name = "github";
+    private subs;
+    private checkRunIds;
+    private revision;
+    private cachedCommentId?;
+    private stepStatusByGroup;
+    private debounceMs;
+    private maxWaitMs;
+    private _timer;
+    private _lastFlush;
+    private _pendingIds;
+    private updateLocks;
+    minUpdateDelayMs: number;
+    private createdCommentGithubIds;
+    start(ctx: FrontendContext): void;
+    stop(): void;
+    private buildFullBody;
+    private threadKeyFor;
+    private renderThreadHeader;
+    private renderSections;
+    /**
+     * Acquires a mutex lock for the given group and executes the update.
+     * This ensures only one comment update happens at a time per group,
+     * preventing race conditions where updates overwrite each other.
+     *
+     * Uses a proper queue-based mutex: each new caller chains onto the previous
+     * lock, ensuring strict serialization even when multiple callers wait
+     * simultaneously.
+     */
+    private updateGroupedComment;
+    /**
+     * Performs the actual comment update with delay enforcement.
+     */
+    private performGroupedCommentUpdate;
+    private deriveTriggeredBy;
+    private mergeIntoExistingBody;
+    private parseSections;
+    private serializeSections;
+    private extractSectionById;
+    private escapeRegExp;
+    private getGroupForCheck;
+    private upsertSectionState;
+    private commentIdForGroup;
+    /**
+     * Compute failure condition results for a completed check so Check Runs map to the
+     * correct GitHub conclusion. This mirrors the engine's evaluation for fail_if.
+     */
+    private evaluateFailureResults;
+    private scheduleUpdate;
+    private flushNow;
+    /**
+     * Sleep utility for enforcing delays
+     */
+    private sleep;
+}
+//# sourceMappingURL=github-frontend.d.ts.map

package/dist/frontends/github-frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-frontend.d.ts","sourceRoot":"","sources":["file:///home/runner/work/visor/visor/src/frontends/github-frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAmBxD,qBAAa,cAAe,YAAW,QAAQ;IAC7C,SAAgB,IAAI,YAAY;IAChC,OAAO,CAAC,IAAI,CAAsC;IAClD,OAAO,CAAC,WAAW,CAAkC;IACrD,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,eAAe,CAAC,CAAS;IAEjC,OAAO,CAAC,iBAAiB,CAAqD;IAG9E,OAAO,CAAC,UAAU,CAAe;IACjC,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAkC;IAGrD,OAAO,CAAC,WAAW,CAAyC;IACrD,gBAAgB,EAAE,MAAM,CAAQ;IAEvC,OAAO,CAAC,uBAAuB,CAAkC;IAEjE,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IA4KjC,IAAI,IAAI,IAAI;YAKE,aAAa;IAU3B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,cAAc;IAetB;;;;;;;;OAQG;YACW,oBAAoB;IA8ClC;;OAEG;YACW,2BAA2B;IAiEzC,OAAO,CAAC,iBAAiB;YAeX,qBAAqB;IA4CnC,OAAO,CAAC,aAAa;IAoErB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAczB;;;OAGG;YACW,sBAAsB;IA6DpC,OAAO,CAAC,cAAc;YAgBR,QAAQ;IAWtB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/frontends/host.d.ts

@@ -0,0 +1,47 @@
+import { EventBus } from '../event-bus/event-bus';
+export interface FrontendContext {
+    eventBus: EventBus;
+    logger: {
+        info: (...a: any[]) => void;
+        warn: (...a: any[]) => void;
+        error: (...a: any[]) => void;
+    };
+    config: unknown;
+    run: {
+        runId: string;
+        workflowId?: string;
+        repo?: {
+            owner: string;
+            name: string;
+        };
+        pr?: number;
+        headSha?: string;
+        event?: string;
+        actor?: string;
+    };
+    octokit?: any;
+    webhookContext?: {
+        webhookData?: Map<string, unknown>;
+        eventType?: string;
+    };
+}
+export interface Frontend {
+    readonly name: string;
+    start(ctx: FrontendContext): Promise<void> | void;
+    stop(): Promise<void> | void;
+}
+export interface FrontendSpec {
+    name: string;
+    package?: string;
+    config?: unknown;
+}
+export declare class FrontendsHost {
+    private bus;
+    private log;
+    private frontends;
+    constructor(bus: EventBus, log: FrontendContext['logger']);
+    load(specs: FrontendSpec[]): Promise<void>;
+    startAll(ctxFactory: () => FrontendContext): Promise<void>;
+    stopAll(): Promise<void>;
+}
+//# sourceMappingURL=host.d.ts.map

package/dist/frontends/host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["file:///home/runner/work/visor/visor/src/frontends/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE;QACN,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QAC5B,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;QAC5B,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;KAC9B,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE;QACH,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACvC,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,EAAE,GAAG,CAAC;IAEd,cAAc,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7E;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAClD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,SAAS,CAAkB;gBAEvB,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,CAAC,QAAQ,CAAC;IAKnD,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1C,QAAQ,CAAC,UAAU,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAW1D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAS/B"}

package/dist/frontends/ndjson-sink.d.ts

@@ -0,0 +1,12 @@
+import type { Frontend, FrontendContext } from './host';
+export declare class NdjsonSink implements Frontend {
+    readonly name = "ndjson-sink";
+    private cfg;
+    private unsub?;
+    private filePath?;
+    constructor(config?: unknown);
+    start(ctx: FrontendContext): void;
+    stop(): void;
+    private resolveFile;
+}
+//# sourceMappingURL=ndjson-sink.d.ts.map

package/dist/frontends/ndjson-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson-sink.d.ts","sourceRoot":"","sources":["file:///home/runner/work/visor/visor/src/frontends/ndjson-sink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAMxD,qBAAa,UAAW,YAAW,QAAQ;IACzC,SAAgB,IAAI,iBAAiB;IACrC,OAAO,CAAC,GAAG,CAAa;IACxB,OAAO,CAAC,KAAK,CAAC,CAA0B;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAS;gBAEd,MAAM,CAAC,EAAE,OAAO;IAI5B,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAoBjC,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,WAAW;CAIpB"}

package/dist/frontends/slack-frontend.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Slack Frontend for Visor workflows.
+ *
+ * Features:
+ * - Posts AI replies to Slack threads
+ * - Converts Markdown to Slack mrkdwn format
+ * - Renders mermaid diagrams to PNG and uploads as images
+ * - Manages 👀/👍 reactions for acknowledgement
+ * - Handles human input prompts via prompt-state
+ *
+ * Mermaid Diagram Rendering:
+ * - Detects ```mermaid code blocks in AI responses
+ * - Renders to PNG using @mermaid-js/mermaid-cli (mmdc)
+ * - Uploads rendered images to Slack thread
+ * - Replaces mermaid blocks with "_(See diagram above)_" placeholder
+ *
+ * Requirements for mermaid rendering:
+ * - Node.js and npx in PATH
+ * - Puppeteer/Chromium dependencies (mermaid-cli uses headless browser)
+ * - On Linux: apt-get install chromium-browser libatk-bridge2.0-0 libgtk-3-0
+ */
+import type { Frontend, FrontendContext } from './host';
+type SlackFrontendConfig = {
+    defaultChannel?: string;
+    groupChannels?: Record<string, string>;
+    debounceMs?: number;
+    maxWaitMs?: number;
+    showRawOutput?: boolean;
+    telemetry?: {
+        enabled?: boolean;
+    };
+};
+export declare class SlackFrontend implements Frontend {
+    readonly name = "slack";
+    private subs;
+    private cfg;
+    private acked;
+    private ackRef;
+    private ackName;
+    private doneName;
+    constructor(config?: SlackFrontendConfig);
+    start(ctx: FrontendContext): void;
+    stop(): void;
+    private getSlack;
+    private getInboundSlackPayload;
+    private getInboundSlackEvent;
+    private ensureAcknowledgement;
+    private finalizeReactions;
+    /**
+     * Post direct replies into the originating Slack thread when appropriate.
+     * This is independent of summary messages and is intended for chat-style flows
+     * (e.g., AI answers and explicit chat/notify steps).
+     */
+    private maybePostDirectReply;
+    private getTraceInfo;
+}
+export {};
+//# sourceMappingURL=slack-frontend.d.ts.map

package/dist/frontends/slack-frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-frontend.d.ts","sourceRoot":"","sources":["file:///home/runner/work/visor/visor/src/frontends/slack-frontend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAUxD,KAAK,mBAAmB,GAAG;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH,CAAC;AAEF,qBAAa,aAAc,YAAW,QAAQ;IAC5C,SAAgB,IAAI,WAAW;IAC/B,OAAO,CAAC,IAAI,CAAsC;IAClD,OAAO,CAAC,GAAG,CAAsB;IAEjC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,QAAQ,CAAsB;gBAE1B,MAAM,CAAC,EAAE,mBAAmB;IAIxC,KAAK,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI;IAgIjC,IAAI,IAAI,IAAI;IAKZ,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,oBAAoB;YAWd,qBAAqB;YAmCrB,iBAAiB;IA6B/B;;;;OAIG;YACW,oBAAoB;IAgKlC,OAAO,CAAC,YAAY;CAWrB"}