@pixelml/agenticflow-cli 1.1.1 → 1.2.1

package/README.md

@@ -42,11 +42,17 @@ af agent list --fields id,name,model --json
 af agent get --agent-id <id> --json
 af agent create --body @agent.json --dry-run    # Validate first
 af agent create --body @agent.json
-af agent stream --agent-id <id> --body @stream.json
+af agent run --agent-id <id> --message "Analyze this" --json   # Non-streaming
+af agent stream --agent-id <id> --body @stream.json            # Streaming
 af agent update --agent-id <id> --body @update.json
 af agent delete --agent-id <id>
 ```
 
+`af agent run` is designed for AI agents and scripts — returns structured JSON:
+```json
+{"schema":"agenticflow.agent.run.v1","status":"completed","thread_id":"...","response":"..."}
+```
+
 ### Workflows
 
 ```bash
@@ -89,6 +95,11 @@ af gateway serve --channels linear
 Deploy agents to [Paperclip](https://github.com/paperclipai/paperclip) companies:
 
 ```bash
+# One-command setup from a blueprint
+af paperclip blueprints                              # List templates
+af paperclip init --blueprint dev-shop               # Bootstrap entire company
+
+# Or step by step
 af paperclip company create --name "My Company" --budget 100000
 af paperclip deploy --agent-id <id> --role engineer
 af paperclip goal create --title "Build the product" --level company
@@ -98,6 +109,8 @@ af paperclip agent wakeup --id <id>     # Trigger execution
 af paperclip dashboard                  # Monitor
 ```
 
+Blueprints: `dev-shop`, `marketing-agency`, `sales-team`, `content-studio`, `support-center`.
+
 ### AI-Agent Discovery
 
 ```bash
@@ -119,13 +132,14 @@ af connections list --limit 200 --json
 ### Playbooks
 
 ```bash
-af playbook quickstart           # Zero to working agent in 5 min
-af playbook gateway-setup        # Webhook gateway setup
-af playbook deploy-to-paperclip  # Paperclip company setup
-af playbook agent-channels       # Connect Linear, webhooks, etc.
-af playbook agent-build          # Agent configuration
-af playbook workflow-build       # Workflow design
-af playbook template-bootstrap   # Start from templates
+af playbook quickstart             # Zero to working agent in 5 min
+af playbook company-from-scratch   # Full Paperclip company setup
+af playbook gateway-setup          # Webhook gateway setup
+af playbook deploy-to-paperclip    # Step-by-step Paperclip deploy
+af playbook agent-channels         # Connect Linear, webhooks, etc.
+af playbook agent-build            # Agent configuration
+af playbook workflow-build         # Workflow design
+af playbook template-bootstrap     # Start from templates
 ```
 
 ## Global Options

package/dist/cli/company-blueprints.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pre-built company blueprints for Paperclip deployment.
+ *
+ * Each blueprint defines a team of AgenticFlow agents that can be
+ * deployed to Paperclip as a ready-made company. Agents are sourced
+ * from the AF marketplace templates or the user's existing agents.
+ */
+export interface AgentSlot {
+    /** Paperclip role */
+    role: string;
+    /** What this slot does */
+    title: string;
+    /** Human description */
+    description: string;
+    /** Suggested AF agent name to search for (from marketplace) */
+    suggestedTemplate?: string;
+    /** Allow user to skip this slot */
+    optional?: boolean;
+}
+export interface CompanyBlueprint {
+    /** Short slug */
+    id: string;
+    /** Display name */
+    name: string;
+    /** What this company does */
+    description: string;
+    /** Company goal */
+    goal: string;
+    /** Starter tasks */
+    starterTasks: Array<{
+        title: string;
+        description: string;
+        assigneeRole: string;
+        priority: string;
+    }>;
+    /** Agent slots to fill */
+    agents: AgentSlot[];
+}
+export declare const BLUEPRINTS: Record<string, CompanyBlueprint>;
+export declare function listBlueprints(): CompanyBlueprint[];
+export declare function getBlueprint(id: string): CompanyBlueprint | null;
+//# sourceMappingURL=company-blueprints.d.ts.map

package/dist/cli/company-blueprints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"company-blueprints.d.ts","sourceRoot":"","sources":["../../src/cli/company-blueprints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpG,0BAA0B;IAC1B,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAiFvD,CAAC;AAEF,wBAAgB,cAAc,IAAI,gBAAgB,EAAE,CAEnD;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAEhE"}

package/dist/cli/company-blueprints.js

@@ -0,0 +1,96 @@
+/**
+ * Pre-built company blueprints for Paperclip deployment.
+ *
+ * Each blueprint defines a team of AgenticFlow agents that can be
+ * deployed to Paperclip as a ready-made company. Agents are sourced
+ * from the AF marketplace templates or the user's existing agents.
+ */
+export const BLUEPRINTS = {
+    "dev-shop": {
+        id: "dev-shop",
+        name: "Software Dev Shop",
+        description: "A lean engineering team that builds and ships software products.",
+        goal: "Build and ship high-quality software products",
+        agents: [
+            { role: "ceo", title: "CEO / Tech Lead", description: "Strategic direction, delegation, project oversight" },
+            { role: "engineer", title: "Senior Engineer", description: "Core development, architecture, code implementation" },
+            { role: "designer", title: "UX Designer", description: "UI/UX design, user research, visual design", optional: true },
+            { role: "qa", title: "QA Engineer", description: "Testing, bug finding, quality assurance", optional: true },
+        ],
+        starterTasks: [
+            { title: "Define product roadmap", description: "Create a 3-month product roadmap with milestones and deliverables.", assigneeRole: "ceo", priority: "high" },
+            { title: "Set up project architecture", description: "Design the technical architecture and set up the development environment.", assigneeRole: "engineer", priority: "high" },
+        ],
+    },
+    "marketing-agency": {
+        id: "marketing-agency",
+        name: "Marketing Agency",
+        description: "A full-service marketing team for content, social media, SEO, and campaigns.",
+        goal: "Drive brand awareness and customer acquisition through multi-channel marketing",
+        agents: [
+            { role: "ceo", title: "Agency Director", description: "Strategy, client relations, campaign oversight" },
+            { role: "cmo", title: "Content Strategist", description: "Content planning, blog posts, newsletters", suggestedTemplate: "Content Writer" },
+            { role: "designer", title: "Visual Designer", description: "Graphics, social media visuals, brand assets", suggestedTemplate: "Visual designer" },
+            { role: "researcher", title: "Market Researcher", description: "Competitive analysis, trend research", suggestedTemplate: "Ari, the Market Researcher", optional: true },
+        ],
+        starterTasks: [
+            { title: "Develop content calendar", description: "Create a 4-week content calendar covering blog posts, social media, and email newsletters.", assigneeRole: "cmo", priority: "high" },
+            { title: "Create brand guidelines", description: "Define color palette, typography, logo usage, and visual style for all marketing materials.", assigneeRole: "designer", priority: "high" },
+            { title: "Competitive landscape report", description: "Research top 5 competitors and summarize their positioning, pricing, and marketing strategies.", assigneeRole: "researcher", priority: "medium" },
+        ],
+    },
+    "sales-team": {
+        id: "sales-team",
+        name: "Sales Team",
+        description: "A sales operation with outreach, research, and customer management.",
+        goal: "Generate qualified leads and close deals",
+        agents: [
+            { role: "ceo", title: "Sales Director", description: "Pipeline management, strategy, team coordination" },
+            { role: "researcher", title: "Sales Researcher", description: "Lead research, company profiling, ICP matching", suggestedTemplate: "Olivia, the Sales Strategist" },
+            { role: "general", title: "SDR / Outreach", description: "Email outreach, follow-ups, scheduling", suggestedTemplate: "Rachel, the Support Agent" },
+        ],
+        starterTasks: [
+            { title: "Define ICP and target list", description: "Create ideal customer profile and build a list of 50 target companies.", assigneeRole: "researcher", priority: "high" },
+            { title: "Write outreach sequences", description: "Draft 3-step email sequences for cold outreach, follow-up, and re-engagement.", assigneeRole: "general", priority: "high" },
+        ],
+    },
+    "content-studio": {
+        id: "content-studio",
+        name: "Content Studio",
+        description: "A creative content production team for video, social, and written content.",
+        goal: "Produce high-quality content across video, social media, and written formats",
+        agents: [
+            { role: "ceo", title: "Creative Director", description: "Content strategy, quality control, brand voice" },
+            { role: "cmo", title: "Social Media Manager", description: "Social media scheduling, engagement, analytics", suggestedTemplate: "Mason, the Social Media Manager" },
+            { role: "engineer", title: "Content Writer", description: "Blog posts, articles, scripts, copy", suggestedTemplate: "Content Writer" },
+            { role: "designer", title: "Visual Creator", description: "Graphics, thumbnails, social visuals", suggestedTemplate: "Visual designer", optional: true },
+        ],
+        starterTasks: [
+            { title: "Create content pillars", description: "Define 3-5 content themes/pillars that align with the brand and audience.", assigneeRole: "ceo", priority: "high" },
+            { title: "Write 5 blog posts", description: "Draft 5 blog posts of 800-1200 words each on the defined content pillars.", assigneeRole: "engineer", priority: "high" },
+            { title: "Design social media templates", description: "Create reusable templates for Instagram, Twitter, and LinkedIn posts.", assigneeRole: "designer", priority: "medium" },
+        ],
+    },
+    "support-center": {
+        id: "support-center",
+        name: "Customer Support Center",
+        description: "A customer support team with triage, resolution, and escalation.",
+        goal: "Provide fast, helpful customer support and maintain high satisfaction",
+        agents: [
+            { role: "ceo", title: "Support Manager", description: "Escalation handling, SLA monitoring, team coordination" },
+            { role: "general", title: "Support Agent", description: "Ticket triage, first response, common issue resolution", suggestedTemplate: "Rachel, the Support Agent" },
+            { role: "researcher", title: "Knowledge Base Manager", description: "FAQ maintenance, documentation, self-service content", optional: true },
+        ],
+        starterTasks: [
+            { title: "Set up support playbook", description: "Create a support playbook with common issues, resolution steps, and escalation criteria.", assigneeRole: "ceo", priority: "high" },
+            { title: "Draft FAQ document", description: "Write an FAQ with the top 20 most common customer questions and answers.", assigneeRole: "researcher", priority: "medium" },
+        ],
+    },
+};
+export function listBlueprints() {
+    return Object.values(BLUEPRINTS);
+}
+export function getBlueprint(id) {
+    return BLUEPRINTS[id] ?? null;
+}
+//# sourceMappingURL=company-blueprints.js.map

package/dist/cli/company-blueprints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"company-blueprints.js","sourceRoot":"","sources":["../../src/cli/company-blueprints.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8BH,MAAM,CAAC,MAAM,UAAU,GAAqC;IAC1D,UAAU,EAAE;QACV,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,kEAAkE;QAC/E,IAAI,EAAE,+CAA+C;QACrD,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,oDAAoD,EAAE;YAC5G,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,qDAAqD,EAAE;YAClH,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,4CAA4C,EAAE,QAAQ,EAAE,IAAI,EAAE;YACrH,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,yCAAyC,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC7G;QACD,YAAY,EAAE;YACZ,EAAE,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,oEAAoE,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;YAC7J,EAAE,KAAK,EAAE,6BAA6B,EAAE,WAAW,EAAE,2EAA2E,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;SAC/K;KACF;IACD,kBAAkB,EAAE;QAClB,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,8EAA8E;QAC3F,IAAI,EAAE,gFAAgF;QACtF,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,gDAAgD,EAAE;YACxG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,2CAA2C,EAAE,iBAAiB,EAAE,gBAAgB,EAAE;YAC3I,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,8CAA8C,EAAE,iBAAiB,EAAE,iBAAiB,EAAE;YACjJ,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,sCAAsC,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE;SACzK;QACD,YAAY,EAAE;YACZ,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,4FAA4F,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;YACvL,EAAE,KAAK,EAAE,yBAAyB,EAAE,WAAW,EAAE,6FAA6F,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;YAC5L,EAAE,KAAK,EAAE,8BAA8B,EAAE,WAAW,EAAE,gGAAgG,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE;SACzM;KACF;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,qEAAqE;QAClF,IAAI,EAAE,0CAA0C;QAChD,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,kDAAkD,EAAE;YACzG,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,gDAAgD,EAAE,iBAAiB,EAAE,8BAA8B,EAAE;YACnK,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,wCAAwC,EAAE,iBAAiB,EAAE,2BAA2B,EAAE;SACpJ;QACD,YAAY,EAAE;YACZ,EAAE,KAAK,EAAE,4BAA4B,EAAE,WAAW,EAAE,wEAAwE,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE;YAC5K,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,+EAA+E,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE;SAC/K;KACF;IACD,gBAAgB,EAAE;QAChB,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,4EAA4E;QACzF,IAAI,EAAE,8EAA8E;QACpF,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,gDAAgD,EAAE;YAC1G,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,gDAAgD,EAAE,iBAAiB,EAAE,iCAAiC,EAAE;YACnK,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,qCAAqC,EAAE,iBAAiB,EAAE,gBAAgB,EAAE;YACtI,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,sCAAsC,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,IAAI,EAAE;SACzJ;QACD,YAAY,EAAE;YACZ,EAAE,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,2EAA2E,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;YACpK,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,2EAA2E,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;YACrK,EAAE,KAAK,EAAE,+BAA+B,EAAE,WAAW,EAAE,uEAAuE,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAC/K;KACF;IACD,gBAAgB,EAAE;QAChB,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EAAE,kEAAkE;QAC/E,IAAI,EAAE,uEAAuE;QAC7E,MAAM,EAAE;YACN,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,wDAAwD,EAAE;YAChH,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,wDAAwD,EAAE,iBAAiB,EAAE,2BAA2B,EAAE;YAClK,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,sDAAsD,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC7I;QACD,YAAY,EAAE;YACZ,EAAE,KAAK,EAAE,yBAAyB,EAAE,WAAW,EAAE,0FAA0F,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE;YACpL,EAAE,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,0EAA0E,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE;SACzK;KACF;CACF,CAAC;AAEF,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,UAAU,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;AAChC,CAAC"}

package/dist/cli/gateway/connector.d.ts

@@ -1,51 +1,45 @@
 /**
- * Channel connector interface — inspired by hermes-agent's platform adapters.
+ * Channel connector interface.
  *
- * A "channel" is any external platform that can send tasks to AgenticFlow
- * agents: Paperclip, Linear, GitHub, Slack, webhooks, etc.
+ * A connector is a THIN protocol translator between an external platform
+ * and the AgenticFlow runtime API. It does NOT contain business logic —
+ * the runtime handles agent execution, thread persistence, RAG, tools, etc.
  *
- * Each connector normalizes platform-specific events into a standard task
- * and posts results back to the originating channel.
+ * Connector responsibilities:
+ *   1. Parse platform webhook → { afAgentId, message, threadId }
+ *   2. Post agent response back to platform
+ *
+ * Runtime responsibilities (NOT the connector's job):
+ *   - Agent execution, streaming, tool calling
+ *   - Thread/session persistence
+ *   - Knowledge retrieval, sub-agents
+ *   - Credit management, permissions
  */
-/** Platform-agnostic task representation (the "MessageEvent" equivalent). */
-export interface NormalizedTask {
-    /** Stable UUID for AF thread continuity across messages. */
-    threadId: string;
-    /** Human-readable identifier, e.g. "PIX-1", "LIN-123". */
-    taskIdentifier: string;
-    /** The full message to send to the AF agent. */
-    message: string;
+/** What the connector extracts from a platform webhook. */
+export interface InboundTask {
     /** AF agent ID to invoke. */
     afAgentId: string;
-    /** Override AF stream URL. */
+    /** Message to send to the agent. */
+    message: string;
+    /** Thread ID for conversation continuity (reuse across calls for same task). */
+    threadId?: string;
+    /** Override AF stream URL (if stored in platform metadata). */
     afStreamUrl?: string;
-    /** Source channel info (for routing responses back). */
-    source: {
-        channel: string;
-        chatId: string;
-        userId?: string;
-        userName?: string;
-    };
-    /** Opaque platform data the connector needs in postResult. */
-    platformContext: Record<string, unknown>;
+    /** Human-readable task label for logging. */
+    label: string;
+    /** Opaque data the connector needs to post results back. */
+    replyContext: Record<string, unknown>;
 }
-/** Channel connector for receiving tasks from an external platform. */
+/** Channel connector — thin protocol translator. */
 export interface ChannelConnector {
-    /** Short slug: paperclip, linear, github, webhook, etc. */
+    /** Short slug: paperclip, linear, github, webhook */
     readonly name: string;
-    /** Human-readable display name. */
-    readonly displayName: string;
     /**
-     * Parse incoming webhook into a NormalizedTask.
-     * Return null to skip (irrelevant event type).
-     * Throw to reject with 400.
+     * Parse incoming webhook → InboundTask.
+     * Return null to acknowledge but skip.
      */
-    parseWebhook(headers: Record<string, string | string[] | undefined>, body: string): Promise<NormalizedTask | null>;
-    /** Post agent response back to the originating channel. */
-    postResult(task: NormalizedTask, resultText: string): Promise<void>;
-    /** Optional: check if the channel is reachable. */
-    healthCheck?(): Promise<boolean>;
+    parseWebhook(headers: Record<string, string | string[] | undefined>, body: string): Promise<InboundTask | null>;
+    /** Post agent response back to originating platform. */
+    postResult(task: InboundTask, resultText: string): Promise<void>;
 }
-/** Registry of available channel connectors. */
-export type ConnectorRegistry = Map<string, ChannelConnector>;
 //# sourceMappingURL=connector.d.ts.map

package/dist/cli/gateway/connector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/cli/gateway/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,8DAA8D;IAC9D,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;;;OAIG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAElC,2DAA2D;IAC3D,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,mDAAmD;IACnD,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC;AAED,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../src/cli/gateway/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACtD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE/B,wDAAwD;IACxD,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE"}

package/dist/cli/gateway/connector.js

@@ -1,11 +1,19 @@
 /**
- * Channel connector interface — inspired by hermes-agent's platform adapters.
+ * Channel connector interface.
  *
- * A "channel" is any external platform that can send tasks to AgenticFlow
- * agents: Paperclip, Linear, GitHub, Slack, webhooks, etc.
+ * A connector is a THIN protocol translator between an external platform
+ * and the AgenticFlow runtime API. It does NOT contain business logic —
+ * the runtime handles agent execution, thread persistence, RAG, tools, etc.
  *
- * Each connector normalizes platform-specific events into a standard task
- * and posts results back to the originating channel.
+ * Connector responsibilities:
+ *   1. Parse platform webhook → { afAgentId, message, threadId }
+ *   2. Post agent response back to platform
+ *
+ * Runtime responsibilities (NOT the connector's job):
+ *   - Agent execution, streaming, tool calling
+ *   - Thread/session persistence
+ *   - Knowledge retrieval, sub-agents
+ *   - Credit management, permissions
  */
 export {};
 //# sourceMappingURL=connector.js.map

package/dist/cli/gateway/connector.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/cli/gateway/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../src/cli/gateway/connector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/cli/gateway/connectors/linear.d.ts

@@ -1,27 +1,20 @@
 /**
- * Linear channel connector.
+ * Linear channel connector (thin).
  *
- * Receives Linear webhooks (issue.create, issue.update, comment.create),
- * fetches issue context, and posts results back as comments.
- *
- * Setup: In Linear → Settings → API → Webhooks, add:
- *   URL: https://your-gateway/webhook/linear
- *   Events: Issues (created, updated), Comments (created)
+ * Translates Linear webhooks → AF runtime call.
+ * Linear webhook events: issue.create, issue.update, comment.create.
  */
-import type { ChannelConnector, NormalizedTask } from "../connector.js";
+import type { ChannelConnector, InboundTask } from "../connector.js";
 export interface LinearConnectorConfig {
     linearApiKey: string;
-    /** Map of Linear team key → AF agent ID. e.g. { "ENG": "af-agent-uuid" } */
+    /** Team key → AF agent ID. e.g. { "ENG": "af-uuid" } */
     agentMapping: Record<string, string>;
-    /** Optional: AF stream URL override per agent. */
-    streamUrlMapping?: Record<string, string>;
 }
 export declare class LinearConnector implements ChannelConnector {
     private config;
     readonly name = "linear";
-    readonly displayName = "Linear";
     constructor(config: LinearConnectorConfig);
-    parseWebhook(_headers: Record<string, string | string[] | undefined>, body: string): Promise<NormalizedTask | null>;
-    postResult(task: NormalizedTask, resultText: string): Promise<void>;
+    parseWebhook(_headers: Record<string, string | string[] | undefined>, body: string): Promise<InboundTask | null>;
+    postResult(task: InboundTask, resultText: string): Promise<void>;
 }
 //# sourceMappingURL=linear.d.ts.map

package/dist/cli/gateway/connectors/linear.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../../../src/cli/gateway/connectors/linear.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAgDD,qBAAa,eAAgB,YAAW,gBAAgB;IAI1C,OAAO,CAAC,MAAM;IAH1B,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,YAAY;gBAEZ,MAAM,EAAE,qBAAqB;IAE3C,YAAY,CAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACvD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA4E3B,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAU1E"}
+{"version":3,"file":"linear.d.ts","sourceRoot":"","sources":["../../../../src/cli/gateway/connectors/linear.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAcD,qBAAa,eAAgB,YAAW,gBAAgB;IAG1C,OAAO,CAAC,MAAM;IAF1B,QAAQ,CAAC,IAAI,YAAY;gBAEL,MAAM,EAAE,qBAAqB;IAE3C,YAAY,CAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACvD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA+CxB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUvE"}

package/dist/cli/gateway/connectors/linear.js

@@ -1,121 +1,76 @@
 /**
- * Linear channel connector.
+ * Linear channel connector (thin).
  *
- * Receives Linear webhooks (issue.create, issue.update, comment.create),
- * fetches issue context, and posts results back as comments.
- *
- * Setup: In Linear → Settings → API → Webhooks, add:
- *   URL: https://your-gateway/webhook/linear
- *   Events: Issues (created, updated), Comments (created)
+ * Translates Linear webhooks → AF runtime call.
+ * Linear webhook events: issue.create, issue.update, comment.create.
  */
-// Minimal Linear GraphQL client
-async function linearQuery(apiKey, query, variables) {
+async function linearGql(apiKey, query, variables) {
     const resp = await fetch("https://api.linear.app/graphql", {
         method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Authorization: apiKey,
-        },
+        headers: { "Content-Type": "application/json", Authorization: apiKey },
         body: JSON.stringify({ query, variables }),
     });
     if (!resp.ok)
-        throw new Error(`Linear API failed (${resp.status})`);
+        throw new Error(`Linear API ${resp.status}`);
     const result = (await resp.json());
     if (result.errors)
-        throw new Error(`Linear GraphQL: ${JSON.stringify(result.errors)}`);
+        throw new Error(JSON.stringify(result.errors));
     return result.data;
 }
-async function linearGetIssue(apiKey, issueId) {
-    const data = (await linearQuery(apiKey, `
-    query($id: String!) {
-      issue(id: $id) {
-        id identifier title description priority priorityLabel
-        state { name }
-        team { key name }
-        assignee { name }
-        labels { nodes { name } }
-        comments { nodes { body user { name } createdAt } }
-      }
-    }
-  `, { id: issueId }));
-    return data.issue;
-}
-async function linearAddComment(apiKey, issueId, body) {
-    await linearQuery(apiKey, `
-    mutation($issueId: String!, $body: String!) {
-      commentCreate(input: { issueId: $issueId, body: $body }) {
-        success
-      }
-    }
-  `, { issueId, body });
-}
 export class LinearConnector {
     config;
     name = "linear";
-    displayName = "Linear";
     constructor(config) {
         this.config = config;
     }
     async parseWebhook(_headers, body) {
         const payload = JSON.parse(body);
-        // Only handle issue creates/updates and comment creates
         const isIssue = payload.type === "Issue" && ["create", "update"].includes(payload.action);
         const isComment = payload.type === "Comment" && payload.action === "create";
         if (!isIssue && !isComment)
             return null;
         const issueId = isComment ? payload.data.issueId : payload.data.id;
-        // Fetch full issue details
-        const issue = await linearGetIssue(this.config.linearApiKey, issueId);
+        // Fetch issue for context
+        const data = (await linearGql(this.config.linearApiKey, `
+      query($id: String!) {
+        issue(id: $id) {
+          id identifier title description priorityLabel
+          state { name }
+          team { key }
+        }
+      }
+    `, { id: issueId }));
+        const issue = data.issue;
         const team = issue.team;
         const teamKey = team?.key ?? "";
-        // Find AF agent for this team
         const afAgentId = this.config.agentMapping[teamKey];
         if (!afAgentId)
-            return null; // No agent mapped for this team — skip
+            return null; // No agent for this team
         const state = issue.state;
-        const labels = issue.labels;
-        const comments = issue.comments;
-        // Build message
-        const parts = [];
-        parts.push("You have received a task from Linear.\n");
-        parts.push(`## Task: ${issue.identifier} — ${issue.title}`);
-        parts.push(`- **Priority:** ${issue.priorityLabel ?? "medium"}`);
-        parts.push(`- **Status:** ${state?.name ?? "unknown"}`);
-        if (labels?.nodes?.length) {
-            parts.push(`- **Labels:** ${labels.nodes.map((l) => l.name).join(", ")}`);
-        }
-        if (issue.description) {
-            parts.push(`\n### Description\n${issue.description}`);
-        }
-        if (comments?.nodes?.length) {
-            parts.push("\n### Recent Comments");
-            for (const c of comments.nodes.slice(-5)) {
-                const user = c.user;
-                parts.push(`- **${user?.name ?? "Unknown"}:** ${c.body}`);
-            }
-        }
-        if (isComment && payload.data.body) {
-            parts.push(`\n### New Comment (trigger)\n${payload.data.body}`);
-        }
-        parts.push("\n## Instructions\nComplete this task. Provide a clear summary of your work.");
+        const parts = [
+            `Task: ${issue.identifier} — ${issue.title}`,
+            `Priority: ${issue.priorityLabel ?? "medium"} | Status: ${state?.name ?? "unknown"}`,
+        ];
+        if (issue.description)
+            parts.push(`Description: ${issue.description}`);
+        if (isComment && payload.data.body)
+            parts.push(`New comment: ${payload.data.body}`);
         return {
-            threadId: issueId, // reuse Linear issue ID as thread for continuity
-            taskIdentifier: issue.identifier ?? issueId,
-            message: parts.join("\n"),
             afAgentId,
-            afStreamUrl: this.config.streamUrlMapping?.[afAgentId],
-            source: {
-                channel: "linear",
-                chatId: teamKey,
-                userName: issue.assignee?.name,
-            },
-            platformContext: { issueId, teamKey },
+            message: parts.join("\n"),
+            threadId: issueId,
+            label: issue.identifier ?? issueId,
+            replyContext: { issueId, teamKey },
         };
     }
     async postResult(task, resultText) {
-        const issueId = task.platformContext.issueId;
+        const issueId = task.replyContext.issueId;
         if (issueId && resultText) {
-            await linearAddComment(this.config.linearApiKey, issueId, `**Agent Response:**\n\n${resultText}`);
+            await linearGql(this.config.linearApiKey, `
+        mutation($issueId: String!, $body: String!) {
+          commentCreate(input: { issueId: $issueId, body: $body }) { success }
+        }
+      `, { issueId, body: `**Agent Response:**\n\n${resultText}` });
         }
     }
 }

package/dist/cli/gateway/connectors/linear.js.map

@@ -1 +1 @@
-{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../../../src/cli/gateway/connectors/linear.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"linear.js","sourceRoot":"","sources":["../../../../src/cli/gateway/connectors/linear.ts"],"names":[],"mappings":"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"}

package/dist/cli/gateway/connectors/paperclip.d.ts

@@ -1,22 +1,18 @@
 /**
- * Paperclip channel connector.
+ * Paperclip channel connector (thin).
  *
- * Receives heartbeat POSTs from Paperclip, fetches issue context,
- * builds agent message, and posts results back as comments.
+ * Translates Paperclip heartbeat POST → AF runtime call.
+ * All execution logic lives in the AF runtime.
  */
-import type { ChannelConnector, NormalizedTask } from "../connector.js";
+import type { ChannelConnector, InboundTask } from "../connector.js";
 export interface PaperclipConnectorConfig {
     paperclipUrl: string;
 }
 export declare class PaperclipConnector implements ChannelConnector {
-    private config;
     readonly name = "paperclip";
-    readonly displayName = "Paperclip";
     private pc;
     constructor(config: PaperclipConnectorConfig);
-    healthCheck(): Promise<boolean>;
-    parseWebhook(_headers: Record<string, string | string[] | undefined>, body: string): Promise<NormalizedTask | null>;
-    postResult(task: NormalizedTask, resultText: string): Promise<void>;
-    private buildMessage;
+    parseWebhook(_headers: Record<string, string | string[] | undefined>, body: string): Promise<InboundTask | null>;
+    postResult(task: InboundTask, resultText: string): Promise<void>;
 }
 //# sourceMappingURL=paperclip.d.ts.map

package/dist/cli/gateway/connectors/paperclip.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paperclip.d.ts","sourceRoot":"","sources":["../../../../src/cli/gateway/connectors/paperclip.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,kBAAmB,YAAW,gBAAgB;IAK7C,OAAO,CAAC,MAAM;IAJ1B,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,eAAe;IACnC,OAAO,CAAC,EAAE,CAAoB;gBAEV,MAAM,EAAE,wBAAwB;IAI9C,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,YAAY,CAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACvD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAmD3B,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAS3D,YAAY;CAiD3B"}
+{"version":3,"file":"paperclip.d.ts","sourceRoot":"","sources":["../../../../src/cli/gateway/connectors/paperclip.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,EAAE,CAAoB;gBAElB,MAAM,EAAE,wBAAwB;IAItC,YAAY,CAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,EACvD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAqDxB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMvE"}