@oh-my-pi/pi-coding-agent 17.2.11 → 17.2.12

package/dist/types/tools/gh-types.d.ts

@@ -0,0 +1,340 @@
+export interface GithubInput {
+    op: "repo_view" | "file_read" | "pr_create" | "pr_checkout" | "pr_push" | "search_issues" | "search_prs" | "search_code" | "search_commits" | "search_repos" | "run_watch";
+    repo?: string;
+    branch?: string;
+    path?: string;
+    pr?: string | string[];
+    force?: boolean;
+    forceWithLease?: boolean;
+    title?: string;
+    body?: string;
+    base?: string;
+    head?: string;
+    draft?: boolean;
+    fill?: boolean;
+    reviewer?: string[];
+    assignee?: string[];
+    label?: string[];
+    query?: string;
+    since?: string;
+    until?: string;
+    dateField?: "created" | "updated";
+    limit?: number;
+    run?: string;
+    tail?: number;
+}
+export interface GhApiSearchResponse<T> {
+    total_count?: number;
+    incomplete_results?: boolean;
+    items?: T[];
+}
+export interface GhApiUser {
+    login?: string;
+    name?: string | null;
+}
+export interface GhApiLabel {
+    name?: string;
+}
+export interface GhApiPullRequestRef {
+    merged_at?: string | null;
+}
+export interface GhApiSearchIssueItem {
+    number?: number;
+    title?: string;
+    state?: string;
+    state_reason?: string | null;
+    user?: GhApiUser | null;
+    labels?: GhApiLabel[];
+    created_at?: string;
+    updated_at?: string;
+    html_url?: string;
+    repository_url?: string;
+    pull_request?: GhApiPullRequestRef | null;
+}
+export interface GhApiSearchCodeItem {
+    name?: string;
+    path?: string;
+    sha?: string;
+    html_url?: string;
+    repository?: {
+        full_name?: string;
+    } | null;
+    text_matches?: Array<{
+        fragment?: string;
+        property?: string;
+    }>;
+}
+export interface GhApiSearchCommitGitActor {
+    name?: string;
+    email?: string;
+    date?: string;
+}
+export interface GhApiSearchCommitItem {
+    sha?: string;
+    node_id?: string;
+    html_url?: string;
+    author?: GhApiUser | null;
+    committer?: GhApiUser | null;
+    commit?: {
+        author?: GhApiSearchCommitGitActor | null;
+        committer?: GhApiSearchCommitGitActor | null;
+        message?: string;
+    } | null;
+    repository?: {
+        full_name?: string;
+    } | null;
+}
+export interface GhApiSearchRepoItem {
+    full_name?: string;
+    description?: string | null;
+    language?: string | null;
+    stargazers_count?: number;
+    forks_count?: number;
+    open_issues_count?: number;
+    archived?: boolean;
+    fork?: boolean;
+    private?: boolean;
+    visibility?: string | null;
+    updated_at?: string;
+    created_at?: string;
+    html_url?: string;
+    owner?: GhApiUser | null;
+}
+export interface GhUser {
+    login?: string;
+    name?: string | null;
+}
+export interface GhLabel {
+    name?: string;
+}
+export interface GhComment {
+    author?: GhUser | null;
+    body?: string;
+    createdAt?: string;
+    url?: string;
+    isMinimized?: boolean;
+    minimizedReason?: string | null;
+}
+export interface GhRepoTopic {
+    name?: string;
+    topic?: {
+        name?: string;
+    };
+}
+export interface GhRepoLanguage {
+    name?: string;
+}
+export interface GhRepoBranch {
+    name?: string;
+}
+export interface GhRepoViewData {
+    nameWithOwner?: string;
+    description?: string | null;
+    url?: string;
+    sshUrl?: string;
+    defaultBranchRef?: GhRepoBranch | null;
+    homepageUrl?: string | null;
+    forkCount?: number;
+    isArchived?: boolean;
+    isFork?: boolean;
+    primaryLanguage?: GhRepoLanguage | null;
+    repositoryTopics?: GhRepoTopic[];
+    stargazerCount?: number;
+    updatedAt?: string;
+    viewerPermission?: string | null;
+    visibility?: string | null;
+}
+export interface GhIssueViewData {
+    author?: GhUser | null;
+    body?: string | null;
+    comments?: GhComment[];
+    createdAt?: string;
+    labels?: GhLabel[];
+    number?: number;
+    state?: string;
+    stateReason?: string | null;
+    title?: string;
+    updatedAt?: string;
+    url?: string;
+}
+export interface GhPrFile {
+    path?: string;
+    additions?: number;
+    deletions?: number;
+    changeType?: string;
+}
+export interface GhPrViewData extends GhIssueViewData {
+    baseRefName?: string;
+    files?: GhPrFile[];
+    headRefName?: string;
+    headRefOid?: string;
+    headRepository?: GhRepoViewData | null;
+    headRepositoryOwner?: GhUser | null;
+    isCrossRepository?: boolean;
+    isDraft?: boolean;
+    maintainerCanModify?: boolean;
+    mergeStateStatus?: string;
+    reviewComments?: GhPrReviewComment[];
+    reviews?: GhPrReview[];
+    reviewDecision?: string;
+}
+export interface GhPrReviewCommit {
+    oid?: string | null;
+}
+export interface GhPrReview {
+    author?: GhUser | null;
+    body?: string | null;
+    commit?: GhPrReviewCommit | null;
+    state?: string | null;
+    submittedAt?: string | null;
+}
+export interface GhPrReviewCommentApi {
+    body?: string | null;
+    created_at?: string | null;
+    html_url?: string | null;
+    id?: number;
+    in_reply_to_id?: number | null;
+    line?: number | null;
+    original_line?: number | null;
+    path?: string | null;
+    side?: string | null;
+    user?: GhUser | null;
+}
+export interface GhPrReviewComment {
+    author?: GhUser | null;
+    body?: string | null;
+    createdAt?: string;
+    id: number;
+    inReplyToId?: number;
+    line?: number;
+    originalLine?: number;
+    path?: string;
+    side?: string;
+    url?: string;
+}
+export interface GhBranchApiResponse {
+    commit?: {
+        sha?: string | null;
+    } | null;
+}
+export interface GhSearchRepository {
+    nameWithOwner?: string;
+}
+export interface GhSearchResult {
+    author?: GhUser | null;
+    createdAt?: string;
+    labels?: GhLabel[];
+    number?: number;
+    repository?: GhSearchRepository | null;
+    state?: string;
+    title?: string;
+    updatedAt?: string;
+    url?: string;
+}
+export interface GhSearchCodeTextMatch {
+    fragment?: string;
+    property?: string;
+}
+export interface GhSearchCodeResult {
+    path?: string;
+    repository?: GhSearchRepository | null;
+    sha?: string;
+    textMatches?: GhSearchCodeTextMatch[];
+    url?: string;
+}
+export interface GhSearchCommitGitActor {
+    name?: string;
+    email?: string;
+    date?: string;
+}
+export interface GhSearchCommitDetail {
+    author?: GhSearchCommitGitActor | null;
+    committer?: GhSearchCommitGitActor | null;
+    message?: string;
+}
+export interface GhSearchCommitResult {
+    author?: GhUser | null;
+    commit?: GhSearchCommitDetail | null;
+    committer?: GhUser | null;
+    id?: string;
+    repository?: GhSearchRepository | null;
+    sha?: string;
+    url?: string;
+}
+export interface GhSearchRepoResult {
+    createdAt?: string;
+    description?: string | null;
+    forksCount?: number;
+    fullName?: string;
+    isArchived?: boolean;
+    isFork?: boolean;
+    isPrivate?: boolean;
+    language?: string | null;
+    openIssuesCount?: number;
+    owner?: GhUser | null;
+    stargazersCount?: number;
+    updatedAt?: string;
+    url?: string;
+    visibility?: string | null;
+}
+export interface GhRunReference {
+    repo?: string;
+    runId?: number;
+}
+export interface GhActionsRunListResponse {
+    workflow_runs?: GhActionsRunApi[];
+}
+export interface GhActionsRunApi {
+    id?: number;
+    name?: string | null;
+    display_title?: string | null;
+    status?: string | null;
+    conclusion?: string | null;
+    head_branch?: string | null;
+    head_sha?: string | null;
+    created_at?: string | null;
+    updated_at?: string | null;
+    html_url?: string | null;
+}
+export interface GhActionsJobsResponse {
+    total_count?: number;
+    jobs?: GhActionsJobApi[];
+}
+export interface GhActionsJobApi {
+    id?: number;
+    name?: string | null;
+    status?: string | null;
+    conclusion?: string | null;
+    started_at?: string | null;
+    completed_at?: string | null;
+    html_url?: string | null;
+}
+export interface GhRunJobSnapshot {
+    id: number;
+    name: string;
+    status?: string;
+    conclusion?: string;
+    startedAt?: string;
+    completedAt?: string;
+    url?: string;
+}
+export interface GhRunSnapshot {
+    id: number;
+    workflowName?: string;
+    displayTitle?: string;
+    status?: string;
+    conclusion?: string;
+    branch?: string;
+    headSha?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    url?: string;
+    jobs: GhRunJobSnapshot[];
+}
+export interface GhFailedJobLog {
+    run: GhRunSnapshot;
+    job: GhRunJobSnapshot;
+    full?: string;
+    tail?: string;
+    available: boolean;
+}

package/dist/types/tools/gh-view.d.ts

@@ -0,0 +1,88 @@
+import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
+import type { Settings } from "../config/settings.js";
+import * as git from "../utils/git.js";
+import type { ToolSession } from "./index.js";
+import type { GhToolDetails } from "./gh.js";
+import type { GhComment, GhIssueViewData, GhPrFile, GhPrReview, GhPrReviewComment, GhPrReviewCommentApi, GhPrViewData, GhRepoViewData, GithubInput } from "./gh-types.js";
+import { type CacheStatus } from "./github-cache.js";
+export declare const GH_REPO_FIELDS: string[];
+export declare const GH_ISSUE_FIELDS: string[];
+export declare const GH_ISSUE_FIELDS_NO_COMMENTS: string[];
+export declare const GH_ISSUE_STATE_REASON_FIELD = "stateReason";
+export declare function ghJsonErrorNamesField(err: unknown, field: string): boolean;
+export declare function dropJsonField(args: readonly string[], field: string): string[] | undefined;
+/** Runs `gh --json` for issue data, retrying without optional stateReason on older gh releases. */
+export declare function githubIssueJsonWithStateReasonFallback<T>(cwd: string, args: readonly string[], signal: AbortSignal | undefined, options?: git.GhCommandOptions): Promise<T>;
+export declare const GH_PR_FIELDS: string[];
+export declare const GH_PR_FIELDS_NO_COMMENTS: string[];
+export declare const GH_REPO_CLONE_FIELDS: string[];
+export declare const REVIEW_COMMENTS_PAGE_SIZE = 100;
+export declare function normalizePrReviewComment(comment: GhPrReviewCommentApi): GhPrReviewComment | null;
+export declare function fetchPrReviewComments(cwd: string, repo: string, prNumber: number, signal?: AbortSignal): Promise<GhPrReviewComment[]>;
+export declare function formatCommentsSection(comments: GhComment[] | undefined): string[];
+export declare function formatReviewsSection(reviews: GhPrReview[] | undefined): string[];
+export declare function formatReviewCommentLocation(comment: GhPrReviewComment): string | undefined;
+export declare function formatReviewCommentsSection(comments: GhPrReviewComment[] | undefined): string[];
+export declare function formatRepoView(data: GhRepoViewData, input: {
+    repo?: string;
+    branch?: string;
+}): string;
+export declare function formatIssueView(data: GhIssueViewData, input: {
+    issue: string;
+    repo?: string;
+    comments?: boolean;
+}): string;
+export declare function formatPrFiles(files: GhPrFile[] | undefined): string[];
+export declare function formatPrView(data: GhPrViewData, input: {
+    pr?: string;
+    repo?: string;
+    comments?: boolean;
+}): string;
+export declare function executeRepoView(session: ToolSession, params: GithubInput, signal: AbortSignal | undefined): Promise<AgentToolResult<GhToolDetails>>;
+export interface IssueViewLookupOptions {
+    cwd: string;
+    repo?: string;
+    /** Issue number or GitHub issue URL. */
+    issue: string;
+    includeComments?: boolean;
+    signal?: AbortSignal;
+    settings?: Settings;
+    cacheAuthKey?: string | null;
+}
+export interface PrViewLookupOptions {
+    cwd: string;
+    repo: string;
+    number: number;
+    includeComments?: boolean;
+    signal?: AbortSignal;
+    settings?: Settings;
+    cacheAuthKey?: string | null;
+}
+export interface ViewLookupResult<T> {
+    rendered: string;
+    sourceUrl: string | undefined;
+    payload: T;
+    status: CacheStatus;
+    fetchedAt: number;
+}
+export declare function fetchIssueViewFresh(cwd: string, repo: string | undefined, identifier: string, includeComments: boolean, signal: AbortSignal | undefined): Promise<{
+    rendered: string;
+    sourceUrl: string | undefined;
+    payload: GhIssueViewData;
+}>;
+export declare function fetchPrViewFresh(cwd: string, repo: string, number: number, includeComments: boolean, signal: AbortSignal | undefined): Promise<{
+    rendered: string;
+    sourceUrl: string | undefined;
+    payload: GhPrViewData;
+}>;
+/**
+ * Cache-aware issue/view fetcher. Used by both the `github` tool op and the
+ * `issue://` protocol handler so a single shared row services both surfaces.
+ */
+export declare function getOrFetchIssue(options: IssueViewLookupOptions): Promise<ViewLookupResult<GhIssueViewData>>;
+/**
+ * Cache-aware PR view fetcher. Caller must supply a numeric PR number;
+ * branch-name / current-branch lookups bypass the cache entirely upstream
+ * (see `executePrView`).
+ */
+export declare function getOrFetchPr(options: PrViewLookupOptions): Promise<ViewLookupResult<GhPrViewData>>;

package/dist/types/tools/gh.d.ts

@@ -1,11 +1,10 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback, ToolApprovalDecision } from "@oh-my-pi/pi-agent-core";
-import type { Settings } from "../config/settings.js";
-import * as git from "../utils/git.js";
 import type { ToolSession } from "./index.js";
-import { type CacheStatus } from "./github-cache.js";
 import type { OutputMeta } from "./output-meta.js";
-/** Runs `gh --json` for issue data, retrying without optional stateReason on older gh releases. */
-export declare function githubIssueJsonWithStateReasonFallback<T>(cwd: string, args: readonly string[], signal: AbortSignal | undefined, options?: git.GhCommandOptions): Promise<T>;
+export { parsePositiveDecimalInt, resolveDefaultRepoMemoized } from "./gh-common.js";
+export { getOrFetchPrDiff, type PrDiffFile, type PrDiffLookupOptions, type PrDiffPayload, parsePrUnifiedDiff, } from "./gh-pr-diff.js";
+export { buildSearchDateQualifier, parseSearchDateBound } from "./gh-search.js";
+export { getOrFetchIssue, getOrFetchPr, githubIssueJsonWithStateReasonFallback, type IssueViewLookupOptions, type PrViewLookupOptions, type ViewLookupResult, } from "./gh-view.js";
 declare const githubSchema: import("@oh-my-pi/omptype").FluentType<{
     assignee?: string[] | undefined;
     base?: string | undefined;
@@ -121,125 +120,6 @@ export interface GhRunWatchViewDetails {
     runs?: GhRunWatchRunDetails[];
     failedLogs?: GhRunWatchFailedLogDetails[];
 }
-interface GhUser {
-    login?: string;
-    name?: string | null;
-}
-interface GhLabel {
-    name?: string;
-}
-interface GhComment {
-    author?: GhUser | null;
-    body?: string;
-    createdAt?: string;
-    url?: string;
-    isMinimized?: boolean;
-    minimizedReason?: string | null;
-}
-interface GhRepoTopic {
-    name?: string;
-    topic?: {
-        name?: string;
-    };
-}
-interface GhRepoLanguage {
-    name?: string;
-}
-interface GhRepoBranch {
-    name?: string;
-}
-interface GhRepoViewData {
-    nameWithOwner?: string;
-    description?: string | null;
-    url?: string;
-    sshUrl?: string;
-    defaultBranchRef?: GhRepoBranch | null;
-    homepageUrl?: string | null;
-    forkCount?: number;
-    isArchived?: boolean;
-    isFork?: boolean;
-    primaryLanguage?: GhRepoLanguage | null;
-    repositoryTopics?: GhRepoTopic[];
-    stargazerCount?: number;
-    updatedAt?: string;
-    viewerPermission?: string | null;
-    visibility?: string | null;
-}
-interface GhIssueViewData {
-    author?: GhUser | null;
-    body?: string | null;
-    comments?: GhComment[];
-    createdAt?: string;
-    labels?: GhLabel[];
-    number?: number;
-    state?: string;
-    stateReason?: string | null;
-    title?: string;
-    updatedAt?: string;
-    url?: string;
-}
-interface GhPrFile {
-    path?: string;
-    additions?: number;
-    deletions?: number;
-    changeType?: string;
-}
-interface GhPrViewData extends GhIssueViewData {
-    baseRefName?: string;
-    files?: GhPrFile[];
-    headRefName?: string;
-    headRefOid?: string;
-    headRepository?: GhRepoViewData | null;
-    headRepositoryOwner?: GhUser | null;
-    isCrossRepository?: boolean;
-    isDraft?: boolean;
-    maintainerCanModify?: boolean;
-    mergeStateStatus?: string;
-    reviewComments?: GhPrReviewComment[];
-    reviews?: GhPrReview[];
-    reviewDecision?: string;
-}
-interface GhPrReviewCommit {
-    oid?: string | null;
-}
-interface GhPrReview {
-    author?: GhUser | null;
-    body?: string | null;
-    commit?: GhPrReviewCommit | null;
-    state?: string | null;
-    submittedAt?: string | null;
-}
-interface GhPrReviewComment {
-    author?: GhUser | null;
-    body?: string | null;
-    createdAt?: string;
-    id: number;
-    inReplyToId?: number;
-    line?: number;
-    originalLine?: number;
-    path?: string;
-    side?: string;
-    url?: string;
-}
-/**
- * Resolve a search date bound to a GitHub-search-compatible literal. Returns
- * either a `YYYY-MM-DD` date (relative durations and date-only inputs) or a
- * full ISO 8601 datetime string (datetime inputs), so the caller can drop it
- * straight into a qualifier like `created:>=<value>`.
- */
-export declare function parseSearchDateBound(raw: string, now?: Date): string;
-/**
- * Build the GitHub-search qualifier (e.g. `created:>=2026-05-09`) for the
- * provided bounds, or `undefined` if neither bound is set.
- */
-export declare function buildSearchDateQualifier(field: string, since: string | undefined, until: string | undefined, now?: Date): string | undefined;
-/**
- * Parse a digit-only decimal positive integer or return undefined. Rejects
- * `1e2`, `0x10`, `12.0`, leading +/-, or any other shape `Number()` would
- * accept — those would otherwise key the cache against the wrong row.
- */
-export declare function parsePositiveDecimalInt(value: string | undefined): number | undefined;
-export declare function resolveDefaultRepoMemoized(cwd: string, signal?: AbortSignal): Promise<string>;
 export declare class GithubTool implements AgentTool<typeof githubSchema, GhToolDetails> {
     private readonly session;
     readonly name = "github";
@@ -302,80 +182,3 @@ export declare class GithubTool implements AgentTool<typeof githubSchema, GhTool
     static createIf(session: ToolSession): GithubTool | null;
     execute(_toolCallId: string, params: GithubInput, signal?: AbortSignal, onUpdate?: AgentToolUpdateCallback<GhToolDetails>, _context?: AgentToolContext): Promise<AgentToolResult<GhToolDetails>>;
 }
-export interface IssueViewLookupOptions {
-    cwd: string;
-    repo?: string;
-    /** Issue number or GitHub issue URL. */
-    issue: string;
-    includeComments?: boolean;
-    signal?: AbortSignal;
-    settings?: Settings;
-    cacheAuthKey?: string | null;
-}
-export interface PrViewLookupOptions {
-    cwd: string;
-    repo: string;
-    number: number;
-    includeComments?: boolean;
-    signal?: AbortSignal;
-    settings?: Settings;
-    cacheAuthKey?: string | null;
-}
-export interface ViewLookupResult<T> {
-    rendered: string;
-    sourceUrl: string | undefined;
-    payload: T;
-    status: CacheStatus;
-    fetchedAt: number;
-}
-/**
- * Cache-aware issue/view fetcher. Used by both the `github` tool op and the
- * `issue://` protocol handler so a single shared row services both surfaces.
- */
-export declare function getOrFetchIssue(options: IssueViewLookupOptions): Promise<ViewLookupResult<GhIssueViewData>>;
-/**
- * Cache-aware PR view fetcher. Caller must supply a numeric PR number;
- * branch-name / current-branch lookups bypass the cache entirely upstream
- * (see `executePrView`).
- */
-export declare function getOrFetchPr(options: PrViewLookupOptions): Promise<ViewLookupResult<GhPrViewData>>;
-export interface PrDiffFile {
-    /** Display path. Prefers the post-image (`b/<path>`) when present. */
-    path: string;
-    additions: number;
-    deletions: number;
-    changeType: "modified" | "added" | "deleted" | "renamed" | "binary";
-    /** Pre-image path for renames/deletes; same as `path` otherwise. */
-    oldPath?: string;
-    /** Byte offset of the section's `diff --git` line in the unified diff. */
-    startOffset: number;
-    /** Byte offset of the next section (or end-of-text). */
-    endOffset: number;
-}
-export interface PrDiffPayload {
-    /** Full unified diff text as returned by `gh pr diff --color never`. */
-    unified: string;
-    files: PrDiffFile[];
-}
-export interface PrDiffLookupOptions {
-    cwd: string;
-    repo: string;
-    number: number;
-    signal?: AbortSignal;
-    settings?: Settings;
-    cacheAuthKey?: string | null;
-}
-/**
- * Split `gh pr diff` output on `^diff --git ` boundaries and parse per-file
- * metadata. The unified diff is preserved verbatim so callers can slice it by
- * byte offsets without re-running gh.
- */
-export declare function parsePrUnifiedDiff(text: string): PrDiffPayload;
-/**
- * Cache-aware PR diff fetcher. Stores the full unified diff plus a parsed
- * file index in a single `pr-diff` cache row so the listing, full-diff, and
- * per-file slice variants of `pr://<n>/diff` share one `gh pr diff`
- * invocation.
- */
-export declare function getOrFetchPrDiff(options: PrDiffLookupOptions): Promise<ViewLookupResult<PrDiffPayload>>;
-export {};

package/dist/types/tools/read-archive.d.ts

@@ -0,0 +1,16 @@
+import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
+import type { ToolSession } from "../sdk.js";
+import type { ReadToolDetails } from "./read.js";
+import { type SuffixMatchCache } from "./read-path-resolution.js";
+import { type ParsedSelector } from "./read-selector.js";
+interface ResolvedArchiveReadPath {
+    absolutePath: string;
+    archiveSubPath: string;
+    suffixResolution?: {
+        from: string;
+        to: string;
+    };
+}
+export declare function resolveArchiveReadPath(session: ToolSession, readPath: string, suffixCache: SuffixMatchCache, signal?: AbortSignal): Promise<ResolvedArchiveReadPath | null>;
+export declare function readArchive(session: ToolSession, readPath: string, parsedSel: ParsedSelector, resolvedArchivePath: ResolvedArchiveReadPath, signal?: AbortSignal): Promise<AgentToolResult<ReadToolDetails>>;
+export {};