beddel 1.0.5 → 1.0.6

package/dist/agents/business-analyzer.yaml

@@ -0,0 +1,99 @@
+# Business Analyzer Agent
+# Analyzes Google Business Profile reviews and generates insights
+#
+# Required Environment Variables:
+# - GOOGLE_CLIENT_ID
+# - GOOGLE_CLIENT_SECRET
+# - GOOGLE_REFRESH_TOKEN
+# - GEMINI_API_KEY (for AI analysis)
+#
+# Input:
+# - accountId: Google Business Account ID
+# - locationId: Location ID to analyze
+
+metadata:
+  name: "Business Analyzer"
+  version: "1.0.0"
+  description: "Analyzes business reviews and generates actionable insights"
+
+workflow:
+  # Step 1: Fetch all reviews with auto-pagination
+  - id: "fetch-reviews"
+    type: "google-business"
+    config:
+      action: "listReviews"
+      accountId: "$input.accountId"
+      locationId: "$input.locationId"
+      pageSize: 100
+      maxPages: 10
+      orderBy: "update_time desc"
+    result: "reviewsData"
+
+  # Step 2: Analyze reviews with AI
+  - id: "analyze-sentiment"
+    type: "llm"
+    config:
+      provider: "google"
+      model: "gemini-2.0-flash-exp"
+      system: |
+        You are a business analytics expert. Analyze the provided reviews and generate a comprehensive report.
+        
+        Your analysis must include:
+        1. Overall sentiment score (1-10)
+        2. Top 5 positive themes with mention counts
+        3. Top 5 areas for improvement with mention counts
+        4. Reviews requiring urgent response (rating <= 2)
+        5. Trend analysis comparing recent vs older reviews
+        6. Actionable recommendations
+        
+        Format your response as structured JSON.
+      messages:
+        - role: "user"
+          content: |
+            Analyze these business reviews:
+            
+            Total Reviews: $stepResult.reviewsData.totalReviewCount
+            Average Rating: $stepResult.reviewsData.averageRating
+            
+            Reviews Data:
+            $stepResult.reviewsData.reviews
+    result: "analysis"
+
+  # Step 3: Generate response suggestions for negative reviews
+  - id: "generate-responses"
+    type: "llm"
+    config:
+      provider: "google"
+      model: "gemini-2.0-flash-exp"
+      system: |
+        You are a customer service expert. For each negative review (rating <= 3),
+        generate a professional, empathetic response suggestion.
+        
+        Guidelines:
+        - Acknowledge the customer's concern
+        - Apologize for their experience
+        - Offer a solution or next steps
+        - Keep responses under 150 words
+        - Be specific to the complaint mentioned
+        
+        Format as JSON array with reviewId and suggestedResponse.
+      messages:
+        - role: "user"
+          content: |
+            Generate response suggestions for these reviews:
+            $stepResult.reviewsData.reviews
+    result: "responseSuggestions"
+
+  # Step 4: Compile final report
+  - id: "compile-report"
+    type: "output-generator"
+    config:
+      template:
+        summary:
+          totalReviews: "$stepResult.reviewsData.totalReviewCount"
+          averageRating: "$stepResult.reviewsData.averageRating"
+          analysisDate: "$input.analysisDate"
+        analysis: "$stepResult.analysis.text"
+        responseSuggestions: "$stepResult.responseSuggestions.text"
+        rawReviews: "$stepResult.reviewsData.reviews"
+    result: "finalReport"

package/dist/agents/index.d.ts

@@ -7,7 +7,7 @@
 /**
  * List of built-in agent IDs available in the package
  */
-export declare const BUILTIN_AGENTS: readonly ["assistant", "assistant-bedrock", "assistant-openrouter", "assistant-gitmcp", "text-generator", "multi-step-assistant"];
+export declare const BUILTIN_AGENTS: readonly ["assistant", "assistant-bedrock", "assistant-openrouter", "assistant-gitmcp", "text-generator", "multi-step-assistant", "business-analyzer"];
 export type BuiltinAgentId = typeof BUILTIN_AGENTS[number];
 /**
  * Get the absolute path to the built-in agents directory

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,eAAO,MAAM,cAAc,mIAOjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAEzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;GAEG;AACH,eAAO,MAAM,cAAc,wJAQjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAE3D;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,cAAc,CAEzE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEnE"}

package/dist/agents/index.js

@@ -19,6 +19,7 @@ export const BUILTIN_AGENTS = [
     'assistant-gitmcp',
     'text-generator',
     'multi-step-assistant',
+    'business-analyzer',
 ];
 /**
  * Get the absolute path to the built-in agents directory

package/dist/core/variable-resolver.d.ts

@@ -2,7 +2,7 @@
  * Beddel Protocol - Variable Resolver
  *
  * Resolves template variables in step configurations.
- * Patterns: $input.path.to.value, $stepResult.path.to.value
+ * Patterns: $input.path.to.value, $stepResult.path.to.value, $env.VAR_NAME
  *
  * Server-only: Used within WorkflowExecutor during step execution.
  */
@@ -11,6 +11,7 @@ import type { ExecutionContext } from '../types';
  * Resolve variable references in a template value.
  *
  * Supports:
+ * - "$env.VAR_NAME" → process.env.VAR_NAME (server-side only)
  * - "$input.messages" → context.input.messages
  * - "$stepResult.llmOutput.text" → context.variables.get('llmOutput').text
  * - Nested objects/arrays are resolved recursively

package/dist/core/variable-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"variable-resolver.d.ts","sourceRoot":"","sources":["../../src/core/variable-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AA6EjD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAsEtF"}
+{"version":3,"file":"variable-resolver.d.ts","sourceRoot":"","sources":["../../src/core/variable-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAoFjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CA6EtF"}

package/dist/core/variable-resolver.js

@@ -2,7 +2,7 @@
  * Beddel Protocol - Variable Resolver
  *
  * Resolves template variables in step configurations.
- * Patterns: $input.path.to.value, $stepResult.path.to.value
+ * Patterns: $input.path.to.value, $stepResult.path.to.value, $env.VAR_NAME
  *
  * Server-only: Used within WorkflowExecutor during step execution.
  */
@@ -39,6 +39,12 @@ function interpolateVariables(template, context) {
     // Matches: $word.word.word... (stops at whitespace, newline, or end)
     const variablePattern = /\$([a-zA-Z_][a-zA-Z0-9_]*(?:\.[a-zA-Z_][a-zA-Z0-9_]*)*)/g;
     return template.replace(variablePattern, (match, fullPath) => {
+        // Handle $env.* pattern (environment variables)
+        if (fullPath.startsWith('env.')) {
+            const envVar = fullPath.slice(4); // Remove "env."
+            const value = process.env[envVar];
+            return value !== undefined ? value : match;
+        }
         // Handle $input.* pattern
         if (fullPath.startsWith('input.')) {
             const path = fullPath.slice(6); // Remove "input."
@@ -76,6 +82,7 @@ function interpolateVariables(template, context) {
  * Resolve variable references in a template value.
  *
  * Supports:
+ * - "$env.VAR_NAME" → process.env.VAR_NAME (server-side only)
  * - "$input.messages" → context.input.messages
  * - "$stepResult.llmOutput.text" → context.variables.get('llmOutput').text
  * - Nested objects/arrays are resolved recursively
@@ -92,6 +99,11 @@ export function resolveVariables(template, context) {
     // Handle string patterns
     if (typeof template === 'string') {
         // Check if entire string is a single variable reference
+        // Check for $env.* pattern (entire string) - environment variables
+        if (template.startsWith('$env.') && !template.includes(' ') && !template.includes('\n')) {
+            const envVar = template.slice(5); // Remove "$env."
+            return process.env[envVar];
+        }
         // Check for $input.* pattern (entire string)
         if (template.startsWith('$input.') && !template.includes(' ') && !template.includes('\n')) {
             const path = template.slice(7); // Remove "$input."

package/dist/core/workflow.d.ts

@@ -9,10 +9,12 @@
  * - If a handler returns a Response instance (streaming), execution stops
  *   and that Response is returned immediately to the client.
  * - Non-Response results are stored in context.variables for subsequent steps.
+ * - If 'return' is defined in YAML, it shapes the final API response.
  */
 import type { ParsedYaml } from '../types';
 export declare class WorkflowExecutor {
     private steps;
+    private returnTemplate?;
     /**
      * Create a new WorkflowExecutor from parsed YAML.
      * @param yaml - Parsed YAML document containing workflow steps
@@ -22,7 +24,7 @@ export declare class WorkflowExecutor {
      * Execute the workflow pipeline.
      *
      * @param input - Input data (e.g., { messages: [...] } for chat)
-     * @returns Response if streaming, or accumulated variables object
+     * @returns Response if streaming, last step result if no 'result' key, or accumulated variables object
      *
      * @example
      * ```typescript

package/dist/core/workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/core/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA8C,MAAM,UAAU,CAAC;AAGvF,qBAAa,gBAAgB;IACzB,OAAO,CAAC,KAAK,CAAiB;IAE9B;;;OAGG;gBACS,IAAI,EAAE,UAAU;IAI5B;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAiC7E"}
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/core/workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA8C,MAAM,UAAU,CAAC;AAIvF,qBAAa,gBAAgB;IACzB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,cAAc,CAAC,CAAU;IAEjC;;;OAGG;gBACS,IAAI,EAAE,UAAU;IAK5B;;;;;;;;;;;;;;;OAeG;IACG,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CA2D7E"}

package/dist/core/workflow.js

@@ -9,22 +9,26 @@
  * - If a handler returns a Response instance (streaming), execution stops
  *   and that Response is returned immediately to the client.
  * - Non-Response results are stored in context.variables for subsequent steps.
+ * - If 'return' is defined in YAML, it shapes the final API response.
  */
 import { handlerRegistry } from '../primitives';
+import { resolveVariables } from './variable-resolver';
 export class WorkflowExecutor {
     steps;
+    returnTemplate;
     /**
      * Create a new WorkflowExecutor from parsed YAML.
      * @param yaml - Parsed YAML document containing workflow steps
      */
     constructor(yaml) {
         this.steps = yaml.workflow;
+        this.returnTemplate = yaml.return;
     }
     /**
      * Execute the workflow pipeline.
      *
      * @param input - Input data (e.g., { messages: [...] } for chat)
-     * @returns Response if streaming, or accumulated variables object
+     * @returns Response if streaming, last step result if no 'result' key, or accumulated variables object
      *
      * @example
      * ```typescript
@@ -41,6 +45,7 @@ export class WorkflowExecutor {
             input,
             variables: new Map(),
         };
+        let lastResult = null;
         for (const step of this.steps) {
             const handler = handlerRegistry[step.type];
             if (!handler) {
@@ -57,8 +62,27 @@ export class WorkflowExecutor {
             if (step.result) {
                 context.variables.set(step.result, result);
             }
+            // Track last result for final return
+            lastResult = result;
         }
-        // No streaming occurred - return accumulated variables as object
+        // If last step has no 'result' key, return its output directly
+        // This allows the final step to define the API response shape
+        const lastStep = this.steps[this.steps.length - 1];
+        if (lastStep && !lastStep.result && lastResult) {
+            return lastResult;
+        }
+        // If 'return' template is defined, resolve and return it
+        // This provides explicit control over the API response contract
+        if (this.returnTemplate !== undefined) {
+            const resolved = resolveVariables(this.returnTemplate, context);
+            // Ensure we return a Record
+            if (typeof resolved === 'object' && resolved !== null && !Array.isArray(resolved)) {
+                return resolved;
+            }
+            // Wrap primitives and arrays in an object
+            return { value: resolved };
+        }
+        // Fallback: return accumulated variables as object
         return Object.fromEntries(context.variables);
     }
 }

package/dist/primitives/google-business.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Beddel Protocol - Google Business Profile Primitive
+ *
+ * Integrates with Google Business Profile APIs to manage reviews,
+ * posts, Q&A, and performance metrics for business locations.
+ *
+ * Server-only: Uses googleapis which requires Node.js.
+ *
+ * Supported Actions:
+ * - listReviews: Fetch all reviews with auto-pagination
+ * - replyReview: Reply to a specific review
+ * - batchGetReviews: Fetch reviews from multiple locations
+ * - createPost: Create a local post
+ * - listPosts: List all posts for a location
+ * - getMetrics: Fetch performance metrics
+ * - listQuestions: List Q&A for a location
+ * - answerQuestion: Answer a question
+ *
+ * @see https://developers.google.com/my-business/content/overview
+ */
+import type { PrimitiveHandler } from '../types';
+/**
+ * Google Business Profile Primitive Handler
+ *
+ * Executes Google Business Profile API operations based on the action specified.
+ * Supports reviews, posts, Q&A, and performance metrics.
+ *
+ * @param config - Step configuration from YAML
+ * @param context - Execution context with input and variables
+ * @returns GoogleBusinessResult with success status and data or error
+ */
+export declare const googleBusinessPrimitive: PrimitiveHandler;
+//# sourceMappingURL=google-business.d.ts.map

package/dist/primitives/google-business.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-business.d.ts","sourceRoot":"","sources":["../../src/primitives/google-business.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAgC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAyjB/E;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAoErC,CAAC"}