@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.9

package/CHANGELOG.md

@@ -9,6 +9,43 @@ any release.
 
 ## [Unreleased]
 
+## [1.0.0-beta.9]
+
+### Added
+
+- Clone GitHub repositories into conversation workspaces and check out pull request heads.
+- Add a `github_pr` tool that pushes agent changes from `pi/*` branches and opens pull requests.
+
+### Changed
+
+- Require GitHub App Contents read and write permission for repository automation.
+- Post completed GitHub responses as single comments instead of streaming edits.
+
+### Fixed
+
+- Keep GitHub issue context inside the history recency window.
+
+### Security
+
+- Require commenters to have repository write permission or higher before triggering the agent.
+- Keep installation tokens out of sandboxes and restrict agent pushes to non-force `pi/*` branches.
+
+### Tests
+
+- Add coverage for GitHub repository checkout, permission gating, pull request creation, and branch restrictions.
+
+## [1.0.0-beta.8]
+
+### Added
+
+- Add a GitHub messaging adapter where each issue or pull request is an independent conversation.
+- Add GitHub App authentication, mention and participation triggers, persisted polling cursors, and downtime replay.
+- Add GitHub adapter deployment configuration and documentation.
+
+### Tests
+
+- Add coverage for GitHub polling, authentication, conversation context, triggers, and responses.
+
 ## [1.0.0-beta.7]
 
 ### Added

package/dist/adapter.d.ts

@@ -1,2 +1,2 @@
-export type { MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler, ChatAdapter, ConversationMessage, ConversationResponder, ChatToolResult, ConversationKind, MessagingInfo, PlatformName, PlatformNotifier, PlatformReactor, RunningSession, } from "./types.js";
+export type { MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler, ChatAdapter, ConversationMessage, ConversationResponder, ChatToolResult, ConversationKind, GithubPrRequest, GithubPrResult, MessagingInfo, PlatformName, PlatformNotifier, PlatformPrCreator, PlatformReactor, RunningSession, } from "./types.js";
 //# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"","sourcesContent":["export type {\n  MessagingBot,\n  ConversationContext,\n  ConversationEvent,\n  MessagingEventHandler,\n  ChatAdapter,\n  ConversationMessage,\n  ConversationResponder,\n  ChatToolResult,\n  ConversationKind,\n  MessagingInfo,\n  PlatformName,\n  PlatformNotifier,\n  PlatformReactor,\n  RunningSession,\n} from \"./types.js\";\n"]}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"","sourcesContent":["export type {\n  MessagingBot,\n  ConversationContext,\n  ConversationEvent,\n  MessagingEventHandler,\n  ChatAdapter,\n  ConversationMessage,\n  ConversationResponder,\n  ChatToolResult,\n  ConversationKind,\n  GithubPrRequest,\n  GithubPrResult,\n  MessagingInfo,\n  PlatformName,\n  PlatformNotifier,\n  PlatformPrCreator,\n  PlatformReactor,\n  RunningSession,\n} from \"./types.js\";\n"]}

package/dist/adapters/github/bot.d.ts

@@ -0,0 +1,63 @@
+import type { ConversationEvent, GithubPrRequest, GithubPrResult, MessagingBot, MessagingEventHandler, MessagingInfo } from "../../adapter.js";
+import { GithubClient } from "./client.js";
+import type { GithubBotConfig, GithubConversationRef } from "./types.js";
+/** GitHub comment bodies cap at 65536 chars; leave headroom for markup. */
+export declare const GITHUB_MAX_COMMENT_LENGTH = 60000;
+export declare const formatGithubContinuation: (partNum: number) => string;
+export declare class GithubMessagingBot implements MessagingBot {
+    private readonly client;
+    private readonly handler;
+    private readonly config;
+    private appSlug;
+    private botEmail;
+    private watchedRepos;
+    private queues;
+    private repoState;
+    private permissionCache;
+    private pollInFlight;
+    constructor(handler: MessagingEventHandler, config: GithubBotConfig, client?: GithubClient);
+    start(): Promise<void>;
+    postMessage(channel: string, text: string): Promise<string>;
+    updateMessage(channel: string, ts: string, text: string): Promise<void>;
+    addReaction(channel: string, messageTs: string, emoji: string): Promise<void>;
+    enqueueEvent(event: ConversationEvent): boolean;
+    getMessagingInfo(): MessagingInfo;
+    postComment(ref: GithubConversationRef, text: string): Promise<number>;
+    deleteComment(ref: GithubConversationRef, commentId: number): Promise<void>;
+    logToFile(conversationId: string, entry: object): void;
+    logBotResponse(conversationId: string, text: string, ts: string): void;
+    private getQueue;
+    /** One poll tick over every watched repo. Public for tests. */
+    poll(): Promise<void>;
+    private pollRepo;
+    private loadSyncState;
+    private persistSyncState;
+    /** Fresh regex per call: the `g` flag makes `test`/`replace` stateful. */
+    private mentionPattern;
+    private isMentioned;
+    private stripMention;
+    private isParticipating;
+    /**
+     * True when `user` holds at least write permission on the repo. Fails
+     * closed: a failed lookup denies the trigger (and logs) rather than
+     * letting an unverified commenter drive the agent.
+     */
+    private hasTriggerPermission;
+    private handleIncoming;
+    private logIssueContext;
+    private repoDir;
+    /**
+     * Clone the conversation's repo into its dir (bind-mounted into the
+     * sandbox) using an ephemeral contents:read token that never leaves the
+     * host. Non-fatal: a failed clone degrades to the pre-clone experience.
+     */
+    private ensureRepoClone;
+    /**
+     * Backs the `github_pr` tool: push a `pi/*` branch the agent prepared in
+     * the conversation's clone, then open a pull request as the App. The write
+     * token is minted per call, scoped to this one repo, and never enters the
+     * sandbox.
+     */
+    pushAndCreatePr(conversationId: string, request: GithubPrRequest): Promise<GithubPrResult>;
+}
+//# sourceMappingURL=bot.d.ts.map

package/dist/adapters/github/bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/github/bot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAe1B,OAAO,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAQhE,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EAMtB,MAAM,YAAY,CAAC;AAsDpB,2EAA2E;AAC3E,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAE/C,eAAO,MAAM,wBAAwB,YAAa,MAAM,KAAG,MAAoC,CAAC;AA6DhG,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,eAAe,CAA0D;IACjF,OAAO,CAAC,YAAY,CAAS;IAE7B,YAAY,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,YAAY,EAUzF;IAMK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAmD3B;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQhE;IAEK,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5E;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAalF;IAED,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAe9C;IAED,gBAAgB,IAAI,aAAa,CAUhC;IAMK,WAAW,CAAC,GAAG,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK3E;IAEK,aAAa,CAAC,GAAG,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF;IAED,SAAS,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAErD;IAED,cAAc,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAErE;IAMD,OAAO,CAAC,QAAQ;IAShB,+DAA+D;IACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB1B;YAEa,QAAQ;IA4DtB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,gBAAgB;IAkBxB,0EAA0E;IAC1E,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;IAIvB;;;;OAIG;YACW,oBAAoB;YA+BpB,cAAc;YA0Fd,eAAe;IAqC7B,OAAO,CAAC,OAAO;IAIf;;;;OAIG;YACW,eAAe;IA8B7B;;;;;OAKG;IACG,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA6B/F;CACF"}