@posthog/agent 1.0.0

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,QAAQ;IAChB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACZ;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,MAAM;IACf,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,YAAiB;IAKrC,QAAQ,CAAC,OAAO,EAAE,OAAO;IAIzB,OAAO,CAAC,aAAa;IAWrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,GAAG;IAY1C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAMhC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAMhC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;IAMjC;;OAEG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;CAMrC"}

package/dist/src/utils/logger.js

@@ -0,0 +1,66 @@
+/**
+ * Simple logger utility with configurable debug mode
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["ERROR"] = 0] = "ERROR";
+    LogLevel[LogLevel["WARN"] = 1] = "WARN";
+    LogLevel[LogLevel["INFO"] = 2] = "INFO";
+    LogLevel[LogLevel["DEBUG"] = 3] = "DEBUG";
+})(LogLevel || (LogLevel = {}));
+export class Logger {
+    debugEnabled;
+    prefix;
+    constructor(config = {}) {
+        this.debugEnabled = config.debug ?? false;
+        this.prefix = config.prefix ?? '[PostHog Agent]';
+    }
+    setDebug(enabled) {
+        this.debugEnabled = enabled;
+    }
+    formatMessage(level, message, data) {
+        const timestamp = new Date().toISOString();
+        const base = `${timestamp} ${this.prefix} ${level} ${message}`;
+        if (data !== undefined) {
+            return `${base} ${JSON.stringify(data, null, 2)}`;
+        }
+        return base;
+    }
+    error(message, error) {
+        // Always log errors
+        if (error instanceof Error) {
+            console.error(this.formatMessage('[ERROR]', message, {
+                message: error.message,
+                stack: error.stack
+            }));
+        }
+        else {
+            console.error(this.formatMessage('[ERROR]', message, error));
+        }
+    }
+    warn(message, data) {
+        if (this.debugEnabled) {
+            console.warn(this.formatMessage('[WARN]', message, data));
+        }
+    }
+    info(message, data) {
+        if (this.debugEnabled) {
+            console.log(this.formatMessage('[INFO]', message, data));
+        }
+    }
+    debug(message, data) {
+        if (this.debugEnabled) {
+            console.log(this.formatMessage('[DEBUG]', message, data));
+        }
+    }
+    /**
+     * Create a child logger with additional prefix
+     */
+    child(childPrefix) {
+        return new Logger({
+            debug: this.debugEnabled,
+            prefix: `${this.prefix} [${childPrefix}]`
+        });
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAChB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACb,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAOD,MAAM,OAAO,MAAM;IACP,YAAY,CAAU;IACtB,MAAM,CAAS;IAEvB,YAAY,SAAuB,EAAE;QACjC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,KAAK,IAAI,KAAK,CAAC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,iBAAiB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAC,OAAgB;QACrB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;IAChC,CAAC;IAEO,aAAa,CAAC,KAAa,EAAE,OAAe,EAAE,IAAU;QAC5D,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;QAE/D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACtD,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,KAAmB;QACtC,oBAAoB;QACpB,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE;gBACjD,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;QACR,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC5B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAAU;QAC5B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC7D,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAAU;QAC7B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC9D,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAmB;QACrB,OAAO,IAAI,MAAM,CAAC;YACd,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,KAAK,WAAW,GAAG;SAC5C,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/src/utils/mcp.d.ts

@@ -0,0 +1,10 @@
+export declare const POSTHOG_MCP: {
+    posthog: {
+        command: string;
+        args: string[];
+        env: {
+            POSTHOG_AUTH_HEADER: string;
+        };
+    };
+};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/src/utils/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../../src/utils/mcp.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW;;;;;;;;CAcvB,CAAC"}

package/dist/src/utils/mcp.js

@@ -0,0 +1,16 @@
+export const POSTHOG_MCP = {
+    posthog: {
+        command: "npx",
+        args: [
+            "-y",
+            "mcp-remote@latest",
+            "https://mcp.posthog.com/mcp",
+            "--header",
+            "Authorization:${POSTHOG_AUTH_HEADER}"
+        ],
+        env: {
+            "POSTHOG_AUTH_HEADER": `Bearer ${process.env.POSTHOG_API_KEY}`
+        }
+    }
+};
+//# sourceMappingURL=mcp.js.map

package/dist/src/utils/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../../src/utils/mcp.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG;IACvB,OAAO,EAAE;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACF,IAAI;YACJ,mBAAmB;YACnB,6BAA6B;YAC7B,UAAU;YACV,sCAAsC;SACzC;QACD,GAAG,EAAE;YACD,qBAAqB,EAAE,UAAU,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE;SACjE;KACJ;CACJ,CAAC"}

package/dist/src/workflow-registry.d.ts

@@ -0,0 +1,11 @@
+import type { WorkflowDefinition } from './workflow-types';
+import { PostHogAPIClient } from './posthog-api';
+export declare class WorkflowRegistry {
+    private workflowsById;
+    private apiClient?;
+    constructor(apiClient?: PostHogAPIClient, staticDefinitions?: WorkflowDefinition[]);
+    loadWorkflows(): Promise<void>;
+    getWorkflow(id: string): WorkflowDefinition | undefined;
+    listWorkflows(): WorkflowDefinition[];
+}
+//# sourceMappingURL=workflow-registry.d.ts.map

package/dist/src/workflow-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-registry.d.ts","sourceRoot":"","sources":["../../src/workflow-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAA8C;IACnE,OAAO,CAAC,SAAS,CAAC,CAAmB;gBAEzB,SAAS,CAAC,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,EAAE,kBAAkB,EAAE;IAO5E,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIvD,aAAa,IAAI,kBAAkB,EAAE;CAGtC"}

package/dist/src/workflow-registry.js

@@ -0,0 +1,26 @@
+import { PostHogAPIClient } from './posthog-api';
+export class WorkflowRegistry {
+    workflowsById = new Map();
+    apiClient;
+    constructor(apiClient, staticDefinitions) {
+        this.apiClient = apiClient;
+        if (staticDefinitions) {
+            for (const w of staticDefinitions)
+                this.workflowsById.set(w.id, w);
+        }
+    }
+    async loadWorkflows() {
+        if (this.apiClient) {
+            const workflows = await this.apiClient.listWorkflows();
+            for (const w of workflows)
+                this.workflowsById.set(w.id, w);
+        }
+    }
+    getWorkflow(id) {
+        return this.workflowsById.get(id);
+    }
+    listWorkflows() {
+        return Array.from(this.workflowsById.values());
+    }
+}
+//# sourceMappingURL=workflow-registry.js.map

package/dist/src/workflow-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-registry.js","sourceRoot":"","sources":["../../src/workflow-registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,OAAO,gBAAgB;IACnB,aAAa,GAAoC,IAAI,GAAG,EAAE,CAAC;IAC3D,SAAS,CAAoB;IAErC,YAAY,SAA4B,EAAE,iBAAwC;QAChF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,iBAAiB,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,iBAAiB;gBAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC;YACvD,KAAK,MAAM,CAAC,IAAI,SAAS;gBAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/src/workflow-types.d.ts

@@ -0,0 +1,45 @@
+import type { PermissionMode, AgentEvent } from './types';
+export type AgentType = 'planning' | 'execution' | 'review' | 'testing';
+export interface AgentDefinition {
+    id: string;
+    name: string;
+    agent_type: AgentType;
+    description?: string;
+    config?: Record<string, any>;
+}
+export interface WorkflowStage {
+    id: string;
+    key: string;
+    name: string;
+    position: number;
+    agent_name?: string | null;
+    is_manual_only?: boolean;
+    color?: string;
+}
+export interface WorkflowDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    stages: WorkflowStage[];
+}
+export interface StageOverrideOptions {
+    permissionMode?: PermissionMode;
+    createPlanningBranch?: boolean;
+    createImplementationBranch?: boolean;
+    openPullRequest?: boolean;
+    queryOverrides?: Record<string, any>;
+}
+export interface WorkflowStageExecutionResult {
+    plan?: string;
+    results?: any[];
+}
+export interface WorkflowExecutionOptions {
+    repositoryPath?: string;
+    permissionMode?: PermissionMode;
+    autoProgress?: boolean;
+    resumeFromCurrentStage?: boolean;
+    stageOverrides?: Record<string, StageOverrideOptions>;
+    onEvent?: (event: AgentEvent) => void;
+    queryOverrides?: Record<string, any>;
+}
+//# sourceMappingURL=workflow-types.d.ts.map

package/dist/src/workflow-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-types.d.ts","sourceRoot":"","sources":["../../src/workflow-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,SAAS,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC"}

package/dist/src/workflow-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow-types.js.map

package/dist/src/workflow-types.js.map

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

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@posthog/agent",
+  "version": "1.0.0",
+  "description": "TypeScript agent framework wrapping Claude Agent SDK with Git-based workflow for PostHog tasks",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "type": "module",
+  "keywords": [
+    "posthog",
+    "claude",
+    "agent",
+    "ai",
+    "git",
+    "workflow",
+    "typescript"
+  ],
+  "author": "PostHog",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/PostHog/posthog-agent"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "example": "bun run example-usage.ts",
+    "dev": "bun run example-usage.ts",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "changeset publish",
+    "prepublishOnly": "bun run build"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.8",
+    "@types/bun": "latest",
+    "typescript": "^5.5.0"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.1",
+    "dotenv": "^17.2.3"
+  },
+  "files": [
+    "dist/**/*",
+    "src/**/*",
+    "README.md",
+    "CLAUDE.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.14.0+sha512.ad27a79641b49c3e481a16a805baa71817a04bbe06a38d17e60e2eaee83f6a146c6a688125f5792e48dd5ba30e7da52a5cda4c3992b9ccf333f9ce223af84748"
+}

package/src/agent-registry.ts

@@ -0,0 +1,60 @@
+import type { AgentDefinition, AgentType } from './workflow-types';
+
+export class AgentRegistry {
+  private agentsByName: Map<string, AgentDefinition> = new Map();
+
+  constructor(definitions?: AgentDefinition[]) {
+    if (definitions) {
+      for (const def of definitions) this.register(def);
+    } else {
+      for (const def of AgentRegistry.getDefaultAgents()) this.register(def);
+    }
+  }
+
+  static getDefaultAgents(): AgentDefinition[] {
+    return [
+      {
+        id: 'planning_basic',
+        name: 'planning_basic',
+        agent_type: 'planning',
+        description: 'Analyze repo and produce implementation plan',
+      },
+      {
+        id: 'code_generation',
+        name: 'code_generation',
+        agent_type: 'execution',
+        description: 'Implements code changes using Claude SDK',
+      },
+      {
+        id: 'review_basic',
+        name: 'review_basic',
+        agent_type: 'review',
+        description: 'Reviews changes and suggests fixes',
+      },
+      {
+        id: 'testing_basic',
+        name: 'testing_basic',
+        agent_type: 'testing',
+        description: 'Runs tests and reports results',
+      },
+    ];
+  }
+
+  register(def: AgentDefinition): void {
+    this.agentsByName.set(def.name, def);
+  }
+
+  getAgent(name: string): AgentDefinition | undefined {
+    return this.agentsByName.get(name);
+  }
+
+  listAgents(): AgentDefinition[] {
+    return Array.from(this.agentsByName.values());
+  }
+
+  exportForPostHog(): { id: string; name: string; agent_type: AgentType; description?: string }[] {
+    return this.listAgents().map(({ id, name, agent_type, description }) => ({ id, name, agent_type, description }));
+  }
+}
+
+