dsh-plugin-github-issues 0.0.0-stage → 0.5.0

package/lib/types/github/state.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The plugin's non-secret state file.
+ *
+ * Preferences (which repo or project the panel shows, the pinned issue, the
+ * handoff template) are not credentials, so they live in the plugin's own
+ * directory instead of the DSH settings profile: the profile patch is rewritten
+ * by upgrades and its `.bak` copies would duplicate whatever is written there.
+ *
+ * @module dsh-plugin-github-issues/github/state
+ */
+import { type IssueLinkRecord, type IssueSessionLinkVM, type Prefs } from '../vm.ts';
+/**
+ * Apply a browser-supplied preference patch onto the current preferences.
+ * @param current - the preferences currently stored.
+ * @param patch - the untrusted patch.
+ * @returns the next preferences, with every field validated.
+ */
+export declare function applyPrefsPatch(current: Prefs, patch: unknown): Prefs;
+/** File-backed preference storage for one installation. */
+export declare class PrefsStore {
+    private readonly stateDir;
+    private readonly configureHandoff;
+    private readonly configureTemplate;
+    private readonly file;
+    private readonly directory;
+    private cached;
+    private cachedLinks;
+    /**
+     * @param stateDir - owner-only directory this installation's state lives in.
+     * @param configureHandoff - the deployment's default handoff mode.
+     * @param configureTemplate - the deployment's default prompt template.
+     */
+    constructor(stateDir: string, configureHandoff: string | undefined, configureTemplate: string | undefined);
+    /** Read the current preferences, creating defaults on first use. */
+    load(): Prefs;
+    /** Every recorded issue → session link, oldest first. */
+    links(): IssueLinkRecord[];
+    /** The links recorded for one issue, newest last. */
+    linksFor(repo: string, number: number): IssueSessionLinkVM[];
+    /** Record one issue → session handoff, idempotently. */
+    link(repo: string, number: number, sessionId: string): IssueLinkRecord[];
+    /** Remove one link (or every link for the issue when `sessionId` is omitted). */
+    unlink(repo: string, number: number, sessionId?: string): IssueLinkRecord[];
+    /** Read the state file once, tolerating absence, v1 files, and corruption. */
+    private readFile;
+    /** Merge one patch into the stored preferences and persist them. */
+    save(patch: unknown): Prefs;
+    /** Write the whole state document atomically with owner-only permissions. */
+    private writeFile;
+}
+//# sourceMappingURL=state.d.ts.map

package/lib/types/github/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/github/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAc,KAAK,eAAe,EAAE,KAAK,kBAAkB,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAA;AAwBhG;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,GAAG,KAAK,CAmCrE;AAED,2DAA2D;AAC3D,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoB;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,WAAW,CAA+B;IAElD;;;;OAIG;gBACS,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,SAAS,EAAE,iBAAiB,EAAE,MAAM,GAAG,SAAS;IAQzG,oEAAoE;IACpE,IAAI,IAAI,KAAK;IAOb,yDAAyD;IACzD,KAAK,IAAI,eAAe,EAAE;IAc1B,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE;IAM5D,wDAAwD;IACxD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAUxE,iFAAiF;IACjF,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE;IAU3E,8EAA8E;IAC9E,OAAO,CAAC,QAAQ;IAkBhB,oEAAoE;IACpE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAO3B,6EAA6E;IAC7E,OAAO,CAAC,SAAS;CAYlB"}

package/lib/types/github/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * The Host-side GitHub contract.
+ *
+ * Pure data in and pure data out: no Cordis types, no transport, no Node imports
+ * beyond the standard library, so the implementation is testable with a fake
+ * fetch and the Remote controller stays a thin forwarding layer.
+ *
+ * @module dsh-plugin-github-issues/github/types
+ */
+import type { IssueBodyVM, IssueCardVM, IssueListPage, IssueListRequest, LinkedPRVM, ProjectRefVM, RepoPageVM, ScopeCatalog } from '../vm.ts';
+/** A token resolved from the machine's `gh` CLI. */
+export interface ResolvedAuth {
+    token: string;
+    /** Where the token came from, for the settings card. */
+    source: 'gh';
+    host: string;
+    login?: string;
+    scopes: string[];
+}
+/** What `gh auth status` says about this machine, without ever exposing the token. */
+export interface GhProbe {
+    installed: boolean;
+    path?: string;
+    signedIn: boolean;
+    login?: string;
+    host?: string;
+    tokenSource?: string;
+    scopes: string[];
+    error?: string;
+}
+/** Options both the probe and the token resolver share. */
+export interface GitHubAuthOptions {
+    host: string;
+    /** Explicit `gh` executable path from Config, when the default lookup fails. */
+    ghPath?: string;
+    signal?: AbortSignal;
+}
+/** Options for one GitHub API session. */
+export interface GitHubApiOptions extends GitHubAuthOptions {
+    token: string;
+}
+/** A classified failure, so the UI can tell "missing scope" from "network down". */
+export declare class GitHubApiError extends Error {
+    readonly code: string;
+    readonly status: number | undefined;
+    constructor(message: string, code: string, status?: number);
+}
+/** The GitHub operations the panel needs. */
+export interface GitHubApi {
+    readonly host: string;
+    /** Repositories, organizations, and the signed-in viewer. */
+    scopes(signal?: AbortSignal): Promise<ScopeCatalog>;
+    /** Projects v2 for one organization; a missing scope degrades to `blocked`. */
+    orgProjects(org: string, signal?: AbortSignal): Promise<{
+        projects: ProjectRefVM[];
+        blocked: boolean;
+        error?: string;
+    }>;
+    /** The organization's repositories (forks included, capped in the implementation). */
+    orgRepos(org: string, signal?: AbortSignal): Promise<RepoPageVM>;
+    /** One page of issues for a list view. */
+    listIssues(request: IssueListRequest, signal?: AbortSignal): Promise<IssueListPage>;
+    /** One repository's milestone titles, for the milestone picker. */
+    repoMilestones(repo: string, signal?: AbortSignal): Promise<{
+        milestones: string[];
+    }>;
+    /** One issue with its body and linked pull requests (no timeline). */
+    issueDetail(repo: string, number: number, signal?: AbortSignal): Promise<IssueBodyVM>;
+    /** The issue's cross-referenced pull requests; the lazy slow leg of the detail. */
+    issueMentionedPRs(repo: string, number: number, signal?: AbortSignal): Promise<{
+        mentionedPRs: LinkedPRVM[];
+    }>;
+    /** Drop cached responses for the next call to refetch. */
+    invalidate(scope?: 'list' | 'detail' | 'all'): void;
+}
+/** Split `owner/name` and reject malformed values before they reach GraphQL. */
+export declare function splitRepo(repo: string): {
+    owner: string;
+    name: string;
+};
+/** The subset of an issue card the prompt formatter needs. */
+export type PromptIssue = Pick<IssueCardVM, 'repo' | 'number' | 'title' | 'url' | 'state' | 'stateReason' | 'labels' | 'milestone' | 'assignees' | 'priority' | 'linkedPRs'>;
+//# sourceMappingURL=types.d.ts.map

package/lib/types/github/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/github/types.ts"],"names":[],"mappings":"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"}

package/lib/types/github/vm.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Pure mapping from GitHub's GraphQL wire shapes to the shared view models.
+ *
+ * Nothing here performs I/O or touches a transport: a raw node goes in, a
+ * renderable value comes out. Keeping the mapping pure is what lets the layout
+ * rules (priority precedence, check glyphs, excerpt length) be tested against
+ * the trimmed JSON captured in the research notes instead of a live API.
+ *
+ * Raw shapes are deliberately loose — every field is optional and nullable — so
+ * a partial or aliased response maps to something sensible rather than crashing
+ * the panel.
+ *
+ * @module dsh-plugin-github-issues/github/vm
+ */
+import type { AssigneeVM, CheckState, IssueCardVM, IssueDetailVM, LabelVM, LinkedPRVM, MilestoneVM, PriorityVM } from '../vm.ts';
+/** The repository reference embedded in an issue or pull request node. */
+export interface RawRepositoryRef {
+    /** `owner/name`. */
+    nameWithOwner?: string | null;
+    /** Whether the repository is private (drives the lock glyph). */
+    isPrivate?: boolean | null;
+}
+/** One label as GraphQL returns it. */
+export interface RawLabel {
+    name?: string | null;
+    /** Bare hex color, no leading `#`. */
+    color?: string | null;
+}
+/** One assignee as GraphQL returns it. */
+export interface RawAssignee {
+    login?: string | null;
+    /** Avatar URL, requested at 32 px. */
+    avatarUrl?: string | null;
+}
+/** One milestone as GraphQL returns it. */
+export interface RawMilestone {
+    title?: string | null;
+    dueOn?: string | null;
+    state?: string | null;
+    progressPercentage?: number | null;
+}
+/** GitHub's org-defined issue type. */
+export interface RawIssueType {
+    name?: string | null;
+    /** A `IssueTypeColor` enum name, e.g. `RED`; not a hex value. */
+    color?: string | null;
+}
+/** One check-run entry of a pull request's status rollup. */
+export interface RawCheckRun {
+    __typename?: string | null;
+    name?: string | null;
+    status?: string | null;
+    conclusion?: string | null;
+}
+/** One legacy commit-status entry of a pull request's status rollup. */
+export interface RawStatusContext {
+    __typename?: string | null;
+    context?: string | null;
+    state?: string | null;
+}
+/** Either kind of entry in `statusCheckRollup.contexts.nodes`. */
+export type RawCheckContext = RawCheckRun | RawStatusContext;
+/** A pull request's rolled-up check state and its individual contexts. */
+export interface RawStatusCheckRollup {
+    state?: string | null;
+    contexts?: {
+        nodes?: (RawCheckContext | null)[] | null;
+    } | null;
+}
+/** A pull request linked to an issue, from either a closing link or a cross-reference. */
+export interface RawLinkedPR {
+    number?: number | null;
+    title?: string | null;
+    url?: string | null;
+    state?: string | null;
+    isDraft?: boolean | null;
+    merged?: boolean | null;
+    reviewDecision?: string | null;
+    updatedAt?: string | null;
+    author?: {
+        login?: string | null;
+    } | null;
+    statusCheckRollup?: RawStatusCheckRollup | null;
+}
+/** One org Issue Field value on an issue (`issueFieldValues.nodes`). */
+export interface RawIssueFieldValue {
+    __typename?: string | null;
+    name?: string | null;
+    /** A `IssueFieldSingleSelectValue` color enum name, e.g. `RED`. */
+    color?: string | null;
+    /** The field definition this value belongs to; only its name is requested. */
+    field?: {
+        name?: string | null;
+    } | null;
+}
+/** The `issueFieldValues` connection embedded in an issue node. */
+export interface RawIssueFieldValues {
+    nodes?: (RawIssueFieldValue | null)[] | null;
+}
+/** An issue node as the list and detail queries select it. */
+export interface RawIssue {
+    /** GraphQL type name, selected where a union has to be told apart. */
+    __typename?: string | null;
+    id?: string | null;
+    number?: number | null;
+    title?: string | null;
+    url?: string | null;
+    state?: string | null;
+    stateReason?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    issueType?: RawIssueType | null;
+    repository?: RawRepositoryRef | null;
+    labels?: {
+        nodes?: (RawLabel | null)[] | null;
+    } | null;
+    milestone?: RawMilestone | null;
+    assignees?: {
+        nodes?: (RawAssignee | null)[] | null;
+    } | null;
+    comments?: {
+        totalCount?: number | null;
+    } | null;
+    body?: string | null;
+    closedByPullRequestsReferences?: {
+        nodes?: (RawLinkedPR | null)[] | null;
+    } | null;
+    issueFieldValues?: RawIssueFieldValues | null;
+}
+/** One `timelineItems` entry; only cross-referenced events are requested. */
+export interface RawTimelineItem {
+    __typename?: string | null;
+    /** The referencing object; only a `PullRequest` source becomes a mentioned PR. */
+    source?: (RawLinkedPR & {
+        __typename?: string | null;
+    }) | null;
+}
+/** A project item's `Priority` field value (`fieldValueByName`). */
+export interface RawProjectFieldValue {
+    __typename?: string | null;
+    /** Single-select option name. */
+    name?: string | null;
+    /** Single-select option color enum, e.g. `RED`. */
+    color?: string | null;
+    /** Text field value. */
+    text?: string | null;
+    /** Number field value. */
+    number?: number | null;
+    /** Date field value. */
+    date?: string | null;
+}
+/**
+ * Project item content, selected through the `Issue | PullRequest | DraftIssue`
+ * union. Fields that only one branch owns are optional, and a stale pull
+ * request's `state` can be `MERGED`; drafts are skipped by the mapper.
+ */
+export interface RawProjectItemContent extends RawIssue {
+    isDraft?: boolean | null;
+    merged?: boolean | null;
+}
+/** One Projects v2 item. */
+export interface RawProjectItem {
+    id?: string | null;
+    /** `ISSUE | PULL_REQUEST | DRAFT_ISSUE | REDACTED`. */
+    type?: string | null;
+    content?: RawProjectItemContent | null;
+    priority?: RawProjectFieldValue | null;
+    /** The project's `Status` single-select value, when defined on the board. */
+    status?: RawProjectFieldValue | null;
+}
+/** Map a raw milestone to its view model, or `undefined` when the issue has none. */
+export declare function toMilestoneVM(node: RawMilestone | null | undefined): MilestoneVM | undefined;
+/** Map a label connection to view models, dropping malformed entries. */
+export declare function toLabelVMs(nodes: readonly (RawLabel | null)[] | null | undefined): LabelVM[];
+/** Map an assignee connection to view models, dropping entries without a login. */
+export declare function toAssigneeVMs(nodes: readonly (RawAssignee | null)[] | null | undefined): AssigneeVM[];
+/** Map the rolled-up check state, or `null` when GitHub reports none. */
+export declare function checkStateOf(rollup: RawStatusCheckRollup | null | undefined): CheckState;
+/**
+ * The names of checks that failed, at most five.
+ * Check runs fail on a terminal bad conclusion; legacy statuses fail on
+ * `FAILURE` or `ERROR`. Pending checks are not counted as failing.
+ */
+export declare function failingChecksOf(rollup: RawStatusCheckRollup | null | undefined): string[];
+/** Map one linked pull request, including its check glyph inputs. */
+export declare function toLinkedPRVM(node: RawLinkedPR): LinkedPRVM;
+/**
+ * Read the `Priority` value out of a project item's `fieldValueByName` answer.
+ * Single-select values carry a name and a color enum; text and number fields
+ * are accepted as names too, because a project may model priority either way.
+ */
+export declare function priorityFromProjectValue(value: RawProjectFieldValue | null | undefined): PriorityVM | undefined;
+/** Read the org-level Issue Field named `Priority`, when the issue has a value. */
+export declare function priorityFromIssueFields(values: RawIssueFieldValues | null | undefined): PriorityVM | undefined;
+/**
+ * Fall back to a `P0`..`P4` label.
+ * When a repository somehow carries several such labels, the lowest number wins
+ * (P0 is the highest priority); the label's own bare hex color is carried along.
+ */
+export declare function priorityFromLabels(labels: readonly (RawLabel | null)[] | null | undefined): PriorityVM | undefined;
+/**
+ * Pick the rendered priority by source precedence:
+ * project field, then org Issue Field, then label.
+ * @param project - priority read from the containing project item.
+ * @param issueField - priority read from the issue's org fields.
+ * @param label - priority read from `P0`..`P4` labels.
+ * @returns the first defined value, or `undefined` when no source has one.
+ */
+export declare function pickPriority(project?: PriorityVM | undefined, issueField?: PriorityVM | undefined, label?: PriorityVM | undefined): PriorityVM | undefined;
+/**
+ * Turn an issue body into a one-line preview.
+ * Headings, images, links, and fences are reduced to their text, whitespace is
+ * collapsed, and the result is cut at `max` characters with an ellipsis.
+ * @param body - the issue body as returned by the API.
+ * @param max - the excerpt budget in characters.
+ * @returns the excerpt, or `undefined` when the body has no text.
+ */
+export declare function bodyExcerpt(body: string, max?: number): string | undefined;
+/** Options the containing surface adds to the generic issue card mapping. */
+export interface IssueCardOptions {
+    /**
+     * Priority read from the containing project item.
+     * It outranks the issue's own org fields and labels.
+     */
+    projectPriority?: PriorityVM | undefined;
+}
+/**
+ * Map one issue node to the list-row view model.
+ * @param node - an issue node from a search, repository, or project query.
+ * @param options - project context, when the node came from a project item.
+ * @returns the card the panel renders.
+ */
+export declare function toIssueCardVM(node: RawIssue, options?: IssueCardOptions): IssueCardVM;
+/**
+ * Map a `timelineItems` connection to mentioned PRs.
+ * Closing references are not filtered here (the caller owns the card); duplicates
+ * are dropped. The panel filters out PRs already listed as closing references.
+ * @param crossRefs - `timelineItems.nodes` from the cross-reference request.
+ * @param closingNumbers - PR numbers already rendered as closing references.
+ * @returns mentioned pull requests in timeline order.
+ */
+export declare function toMentionedPRsVM(crossRefs: readonly (RawTimelineItem | null)[] | null | undefined, closingNumbers?: ReadonlySet<number>): LinkedPRVM[];
+/**
+ * Map one issue node plus its cross-references to the detail view.
+ * `mentionedPRs` excludes PRs that already appear as closing references, since
+ * the panel renders those separately.
+ * @param node - the issue node from the detail query.
+ * @param crossRefs - the issue's `timelineItems.nodes` (cross-referenced events).
+ * @returns the detail the composer dock renders.
+ */
+export declare function toIssueDetailVM(node: RawIssue, crossRefs: readonly (RawTimelineItem | null)[] | null | undefined): IssueDetailVM;
+/**
+ * Map one Projects v2 item to a card.
+ * Draft issues and redacted items have no repository or number and are
+ * skipped; pull requests are rendered as issue-like cards, closed when merged.
+ * @param item - one node of a project's `items` connection.
+ * @returns the card, or `undefined` when the item is not renderable.
+ */
+export declare function toProjectItemCardVM(item: RawProjectItem | null | undefined): IssueCardVM | undefined;
+//# sourceMappingURL=vm.d.ts.map

package/lib/types/github/vm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm.d.ts","sourceRoot":"","sources":["../../../src/github/vm.ts"],"names":[],"mappings":"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"}

package/lib/types/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The bundle's Host entry point.
+ *
+ * A bundle is a configuration layer, so this module exists to do the one thing a
+ * layer cannot: own the live GitHub service and the machine-local preferences, and
+ * expose them to the browser through the plugin's own Remote namespace.
+ *
+ * @module dsh-plugin-github-issues
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** What this plugin calls itself in diagnostics. */
+export declare const name = "github-issues";
+/**
+ * Everything an installation may tune.
+ *
+ * No token lives here on purpose: the deployment's patch and its `.bak` copies
+ * would duplicate it. The token is read from the machine's `gh` CLI at call time.
+ */
+export declare const Config: import("@deepseek-ai/schemastery").Schema<{
+    authMode: string;
+    host: string;
+    ghPath: string;
+    handoffMode: string;
+    pollSeconds: number;
+    stateDir: string;
+    promptTemplate: string;
+}> & {
+    toJSON(): unknown;
+};
+/** The configuration one installation supplies, as the harness resolves it. */
+export type Config = {
+    authMode: string;
+    host: string;
+    ghPath: string;
+    handoffMode: string;
+    pollSeconds: number;
+    stateDir: string;
+    promptTemplate: string;
+};
+/**
+ * Register the GitHub service.
+ * @param ctx - the plugin context.
+ * @param config - the installation's configuration.
+ */
+export declare function apply(ctx: Context, config: Config): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAQlD,oDAAoD;AACpD,eAAO,MAAM,IAAI,kBAAkB,CAAA;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;CAejB,CAAA;AAEF,+EAA+E;AAC/E,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;CACvB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAmBxD"}

package/lib/types/prompt.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Turning one issue into the prompt a handoff writes into the composer.
+ *
+ * Kept apart from the UI so the exact wording is testable, and so the Host can
+ * reuse it when it needs to describe an issue without the browser.
+ *
+ * @module dsh-plugin-github-issues/prompt
+ */
+import type { PromptIssue } from './github/types.ts';
+/**
+ * Render the handoff prompt for one issue.
+ * @param issue - the card the user dragged or clicked.
+ * @param template - the configured template; `{{token}}` placeholders are replaced.
+ * @returns the prompt text, trimmed to a size the composer handles comfortably.
+ */
+export declare function renderPrompt(issue: PromptIssue, template: string): string;
+/** The invisible draft placeholder that keeps the native send enabled. */
+export declare const EMPTY_DRAFT_HOLD = "\u200B\n";
+/**
+ * Compose the message a pending issue card sends.
+ *
+ * The card carries the issue prompt; the user's own words are optional and are
+ * appended after a blank line. The invisible composer placeholder is stripped.
+ *
+ * @param prompt - the rendered issue prompt from the card.
+ * @param memo - the user's text from the composer (may contain the placeholder).
+ * @returns the text to submit.
+ */
+export declare function composeHandoffPrompt(prompt: string, memo: string): string;
+//# sourceMappingURL=prompt.d.ts.map

package/lib/types/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AA0CpD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAezE;AAED,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzE"}

package/lib/types/remote-methods.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The Remote surface, described once for both halves.
+ *
+ * The browser half cannot use the generated `ctx.remote.*` aggregate: that is
+ * assembled at build time from a fixed list of shipped packages. So the client
+ * mounts its own contribution (see `src/client/remote.ts`) built from this table,
+ * and the Host half decorates exactly these methods with `@Remote`. A method added
+ * to one side and forgotten here fails only when a user clicks.
+ *
+ * @module dsh-plugin-github-issues/remote-methods
+ */
+/** One argument of a Remote method. */
+export interface RemoteParameter {
+    /** Wire name the Gateway builds the call from. */
+    wire: string;
+    /** Whether the Host declares this argument optional (still sent as explicit `undefined`). */
+    optional?: boolean;
+}
+/** One method the Host exposes, with the wire name of each argument. */
+export interface RemoteMethod {
+    /** Method name on the controller. */
+    method: string;
+    /** Arguments, in call order. */
+    parameters: readonly RemoteParameter[];
+}
+/** Every method the browser may call. */
+export declare const REMOTE_METHODS: readonly RemoteMethod[];
+/** The Cordis service key the controller registers, and the descriptor's `service` field. */
+export declare const REMOTE_SERVICE_KEY = "githubIssuesController";
+/** The wire namespace both halves address this surface by. */
+export declare const REMOTE_NAMESPACE = "githubIssues";
+//# sourceMappingURL=remote-methods.d.ts.map

package/lib/types/remote-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-methods.d.ts","sourceRoot":"","sources":["../../src/remote-methods.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAA;IACd,gCAAgC;IAChC,UAAU,EAAE,SAAS,eAAe,EAAE,CAAA;CACvC;AAED,yCAAyC;AACzC,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAejD,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,iBAAiB,CAAA"}