@dxos/plugin-github 0.7.4 → 0.14.0

package/dist/lib/GitHubCapabilities.mjs

@@ -0,0 +1,10 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Capability from "@dxos/app-framework/Capability";
+import { meta } from "#meta";
+//#region src/types/GitHubCapabilities.ts
+var GitHubCapabilities_exports = /* @__PURE__ */ __exportAll({ LinkSource: () => LinkSource });
+var LinkSource = Capability.make()(`${meta.profile.key}.capability.linkSource`);
+//#endregion
+export { LinkSource, GitHubCapabilities_exports as t };
+
+//# sourceMappingURL=GitHubCapabilities.mjs.map

package/dist/lib/GitHubCapabilities.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubCapabilities.mjs","names":[],"sources":["../../src/types/GitHubCapabilities.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport type * as Effect from 'effect/Effect';\n\nimport * as Capability from '@dxos/app-framework/Capability';\nimport type * as PreviewCapabilities from '@dxos/plugin-preview/PreviewCapabilities';\nimport { type Issue, type PullRequest, type Repo } from '@dxos/types';\n\nimport { meta } from '#meta';\n\nimport { type GitHubLink } from '../extensions/index.ts';\n\n/**\n * Where a previewed link's repository, pull request or issue comes from. The plugin's default fetches it from\n * the GitHub API with the space's connection token (anonymously when there is none); a host that\n * contributes one — a story, a test, an offline build — replaces the fetch.\n */\nexport type GitHubLinkSource = (\n  link: GitHubLink,\n  context: PreviewCapabilities.PreviewLinkContext,\n) => Effect.Effect<Repo.Repo | Issue.Issue | PullRequest.PullRequest | undefined>;\n\nexport const LinkSource = Capability.make<GitHubLinkSource>()(`${meta.profile.key}.capability.linkSource`);\n"],"mappings":";;;;;AA0BA,IAAa,aAAa,WAAW,KAAuB,CAAC,CAAC,GAAG,KAAK,QAAQ,IAAI,uBAAuB"}

package/dist/lib/GitHubEvents.mjs

@@ -0,0 +1,15 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { meta } from "#meta";
+import * as ActivationEvent from "@dxos/app-framework/ActivationEvent";
+//#region src/types/GitHubEvents.ts
+var GitHubEvents_exports = /* @__PURE__ */ __exportAll({ Start: () => Start });
+/**
+* The feature's start event: the plugin's start-gated modules (and cross-plugin
+* contributions consumed by this feature) activate here. Fired on demand and by the
+* host's idle trickle.
+*/
+var Start = ActivationEvent.pluginStart(meta.profile.key);
+//#endregion
+export { Start, GitHubEvents_exports as t };
+
+//# sourceMappingURL=GitHubEvents.mjs.map

package/dist/lib/GitHubEvents.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubEvents.mjs","names":[],"sources":["../../src/types/GitHubEvents.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as ActivationEvent from '@dxos/app-framework/ActivationEvent';\n\nimport { meta } from '#meta';\n\n/**\n * The feature's start event: the plugin's start-gated modules (and cross-plugin\n * contributions consumed by this feature) activate here. Fired on demand and by the\n * host's idle trickle.\n */\nexport const Start = ActivationEvent.pluginStart(meta.profile.key);\n"],"mappings":";;;;;;;;;;AAeA,IAAa,QAAQ,gBAAgB,YAAY,KAAK,QAAQ,GAAG"}

package/dist/lib/GitHubOperation.mjs

@@ -0,0 +1,384 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { Walkthrough } from "./Walkthrough.mjs";
+import * as ConnectorSpec from "@dxos/plugin-connector/ConnectorSpec";
+import * as Operation from "@dxos/compute/Operation";
+import { PullRequest } from "@dxos/types";
+import { DXN, Database, Obj, Ref } from "@dxos/echo";
+import * as Schema from "effect/Schema";
+import { AiService } from "@dxos/ai";
+import * as Trace from "@dxos/compute/Trace";
+import * as PageAction from "@dxos/plugin-crx/PageAction";
+//#region src/types/GitHubOperation.ts
+var GitHubOperation_exports = /* @__PURE__ */ __exportAll({
+	AddPullRequestComment: () => AddPullRequestComment,
+	AddPullRequestReviewComment: () => AddPullRequestReviewComment,
+	CheckCounts: () => CheckCounts,
+	CheckOutcome: () => CheckOutcome,
+	CheckRun: () => CheckRun,
+	CiState: () => CiState,
+	GenerateWalkthrough: () => GenerateWalkthrough,
+	GetGitHubRepositories: () => GetGitHubRepositories,
+	GetPullRequestDiff: () => GetPullRequestDiff,
+	GetPullRequestStatus: () => GetPullRequestStatus,
+	ImportPullRequest: () => ImportPullRequest,
+	ImportPullRequestFromSnapshot: () => ImportPullRequestFromSnapshot,
+	MaterializeGitHubTarget: () => MaterializeGitHubTarget,
+	RefreshPullRequests: () => RefreshPullRequests,
+	ReviewState: () => ReviewState,
+	SubmitPullRequestApproval: () => SubmitPullRequestApproval,
+	SyncGitHubRepositories: () => SyncGitHubRepositories,
+	SyncOptions: () => SyncOptions,
+	SyncPullRequest: () => SyncPullRequest,
+	createWalkthroughProgressKey: () => createWalkthroughProgressKey
+});
+/**
+* Discovery only — list GitHub repositories the connection's token can see.
+* Returns one descriptor per repo across all the user's orgs (and personal
+* account). Read-only: NEVER materializes local objects — materialization is
+* handled by the connector's `materializeTarget` when a `Cursor` is created.
+*
+* Orgs and their members are NOT presented as sync targets — they are
+* auto-synced as part of the sync of any repo they own.
+*/
+var GetGitHubRepositories = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.getRepositories"),
+		name: "Get GitHub Repositories",
+		description: "List GitHub repositories reachable from a connection without materializing local objects.",
+		icon: "ph--github-logo--regular"
+	},
+	input: ConnectorSpec.GetSyncTargetsInput,
+	output: ConnectorSpec.GetSyncTargetsOutput
+});
+/**
+* Find-or-create the empty local root Project for a selected GitHub repo so a
+* cursor can reference it as its `spec.target`. Keyed by the repo's
+* GitHub foreign id (`remoteTarget.id`), so it is idempotent across re-selection.
+*/
+var MaterializeGitHubTarget = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.materializeTarget"),
+		name: "Materialize GitHub Target",
+		description: "Create the empty local root Project bound to a selected GitHub repository.",
+		icon: "ph--github-logo--regular"
+	},
+	input: ConnectorSpec.MaterializeTargetInput,
+	output: ConnectorSpec.MaterializeTargetOutput
+});
+/**
+* Per-target options. `maxDaysBack` caps how far back issues/PRs are pulled
+* (mirrors the Gmail mailbox `daysBack`). Default — when unset — is "sync
+* everything ever opened or edited."
+*/
+var SyncOptions = Schema.Struct({ maxDaysBack: Schema.Number.annotate({
+	title: "Sync history (days)",
+	description: "Pull issues and PRs updated within this many days. Leave empty to sync everything."
+}).pipe(Schema.optional) });
+/**
+* Reconcile GitHub data for every repo bound to a connection (one cursor per repo).
+*
+* Pull-then-push per bound repo: auto-upsert its owning org + members,
+* three-way merge the repo as a Project and its issues/PRs as Tasks (respecting
+* `maxDaysBack` if set), then push diverged Project/Task fields back to GitHub.
+* Sync state (`lastTick`/`lastError`/`spec.snapshots`) is written onto each binding.
+*/
+var SyncGitHubRepositories = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.syncRepositories"),
+		name: "Sync GitHub Repositories",
+		description: "Reconcile every bound GitHub repo plus its owning org, members, issues, PRs, and comments.",
+		icon: "ph--arrows-clockwise--regular"
+	},
+	input: ConnectorSpec.SyncInput,
+	output: Schema.Struct({ pulled: Schema.Struct({
+		organizations: Schema.Number,
+		people: Schema.Number,
+		projects: Schema.Number,
+		tasks: Schema.Number,
+		comments: Schema.Number
+	}) })
+}).pipe(Operation.visible);
+/**
+* Import a pull request named by a github.com URL or `owner/repo#123` into the space, so it can be
+* opened, reviewed and walked through without waiting for a sync of the whole repository.
+*
+* Idempotent by coordinates — a pull request the space already holds is returned as it stands
+* rather than duplicated.
+*/
+var ImportPullRequest = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.importPullRequest"),
+		name: "Import Pull Request",
+		description: "Add a pull request to the space, named by its URL or as owner/repo#number.",
+		icon: "ph--git-pull-request--regular"
+	},
+	services: [Database.Service],
+	input: Schema.Struct({ 
+	/** A github.com pull request URL, or `owner/repo#123`. */
+reference: Schema.String }),
+	output: Schema.Struct({
+		pullRequest: Ref.Ref(PullRequest.PullRequest),
+		/** False where the space already held the pull request, which is then returned unchanged. */
+		imported: Schema.Boolean
+	}),
+	types: [PullRequest.PullRequest]
+}).pipe(Operation.visible, Operation.mutation("write"));
+/**
+* Import the pull request the browser extension is looking at, named by the page's own URL.
+*
+* Separate from {@link ImportPullRequest} because the extension bridge invokes every page action
+* with the fixed `{ snapshot, target }` shape and reads an `{ id }` back. Nothing is extracted from
+* the page: the URL in the snapshot's source names the pull request, and GitHub is the authority on
+* everything else.
+*/
+var ImportPullRequestFromSnapshot = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.importPullRequestFromSnapshot"),
+		name: "Open pull request in Composer",
+		description: "Import the pull request a browser page shows, named by that page's URL.",
+		icon: "ph--git-pull-request--regular"
+	},
+	input: Schema.Struct({
+		snapshot: PageAction.Snapshot,
+		target: Database.Database.annotate({ description: "The database to add the pull request to." })
+	}),
+	output: Schema.Struct({ id: Schema.String }),
+	types: [PullRequest.PullRequest]
+}).pipe(Operation.mutation("write"));
+/**
+* Generate a walkthrough of a pull request: one markdown document narrating the change in reading
+* order, with its diff chunks spliced in from the patch itself.
+*
+* Idempotent by commit — a walkthrough already generated for the pull request's head is returned
+* unchanged unless `force` says otherwise, since the answer cannot have changed.
+*/
+var GenerateWalkthrough = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.generateWalkthrough"),
+		name: "Generate Walkthrough",
+		description: "Narrate a pull request as one markdown document, with the change's diffs embedded in it.",
+		icon: "ph--path--regular"
+	},
+	input: Schema.Struct({
+		pullRequest: Ref.Ref(PullRequest.PullRequest),
+		/** Regenerate even where a walkthrough for this head already exists. */
+		force: Schema.Boolean.pipe(Schema.optional)
+	}),
+	output: Schema.Struct({
+		walkthrough: Ref.Ref(Walkthrough),
+		/** Whether the model ran, as against an existing walkthrough being returned unchanged. */
+		generated: Schema.Boolean,
+		/** Hunks the prose accounts for, over the patch's total. */
+		covered: Schema.Number,
+		total: Schema.Number
+	}),
+	types: [Walkthrough, PullRequest.PullRequest],
+	services: [Trace.TraceService, AiService.AiService]
+}).pipe(Operation.visible);
+/**
+* Submit an approving review on a pull request, as the space's GitHub connection.
+*
+* Falls back to a marked conversation comment where GitHub refuses the review — the author's own
+* pull request, or a token with no review permission — so the approval is still recorded and still
+* detectable by an agent deciding whether the pull request is good to land.
+*/
+var SubmitPullRequestApproval = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.submitPullRequestApproval"),
+		name: "Submit Pull Request Approval",
+		description: "Submit an approving review on a pull request, or record the approval as a comment.",
+		icon: "ph--check-circle--regular"
+	},
+	input: Schema.Struct({
+		pullRequest: Ref.Ref(PullRequest.PullRequest),
+		/** Optional review summary. */
+		body: Schema.String.pipe(Schema.optional)
+	}),
+	output: Schema.Struct({
+		/** Set where the approving review was accepted. */
+		reviewId: Schema.Number.pipe(Schema.optional),
+		/** Set instead where the approval was recorded as a comment. */
+		commentId: Schema.Number.pipe(Schema.optional),
+		url: Schema.String.pipe(Schema.optional),
+		/** Whether the approval is a comment rather than a review. */
+		commented: Schema.Boolean
+	}),
+	types: [PullRequest.PullRequest]
+});
+/** Post a conversation comment on a pull request, as the space's GitHub connection. */
+var AddPullRequestComment = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.addPullRequestComment"),
+		name: "Add Pull Request Comment",
+		description: "Post a comment on a pull request.",
+		icon: "ph--chat-text--regular"
+	},
+	input: Schema.Struct({
+		pullRequest: Ref.Ref(PullRequest.PullRequest),
+		body: Schema.String
+	}),
+	output: Schema.Struct({
+		commentId: Schema.Number,
+		url: Schema.String.pipe(Schema.optional)
+	}),
+	types: [PullRequest.PullRequest]
+});
+/** Post a review comment on one line of a pull request's diff, as the space's GitHub connection. */
+var AddPullRequestReviewComment = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.addPullRequestReviewComment"),
+		name: "Add Pull Request Review Comment",
+		description: "Post a review comment on a line of a pull request diff.",
+		icon: "ph--chat-centered-text--regular"
+	},
+	input: Schema.Struct({
+		pullRequest: Ref.Ref(PullRequest.PullRequest),
+		body: Schema.String,
+		/** Head SHA the line numbers refer to; a walkthrough's `commit`. */
+		commit: Schema.String,
+		path: Schema.String,
+		line: Schema.Number,
+		/** `LEFT` for the removed side, `RIGHT` for added and context lines. */
+		side: Schema.Literals(["LEFT", "RIGHT"])
+	}),
+	output: Schema.Struct({
+		commentId: Schema.Number,
+		url: Schema.String.pipe(Schema.optional)
+	}),
+	types: [PullRequest.PullRequest]
+});
+/**
+* Re-read a stored pull request from GitHub and write back whatever has changed — its title, state,
+* description, branches and size — so the object in the space does not go stale between syncs.
+*/
+var SyncPullRequest = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.syncPullRequest"),
+		name: "Sync Pull Request",
+		description: "Refresh a stored pull request from GitHub.",
+		icon: "ph--arrows-clockwise--regular"
+	},
+	input: Schema.Struct({ pullRequest: Ref.Ref(PullRequest.PullRequest) }),
+	output: Schema.Struct({ 
+	/** Names of the fields that changed; empty where the stored pull request was already current. */
+updated: Schema.Array(Schema.String) }),
+	types: [PullRequest.PullRequest]
+}).pipe(Operation.mutation("write"));
+/**
+* Refresh every pull request in the space that is still in flight (open or draft) from GitHub.
+*
+* Run on a schedule by the space's refresh trigger (see `ensureRefreshTrigger`), so pull requests the
+* user is not looking at still track their state; one unreachable pull request does not fail the rest.
+*/
+var RefreshPullRequests = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.refreshPullRequests"),
+		name: "Refresh Pull Requests",
+		description: "Refresh every open pull request in the space from GitHub.",
+		icon: "ph--arrows-clockwise--regular"
+	},
+	services: [Database.Service],
+	input: Schema.Struct({}),
+	output: Schema.Struct({
+		/** Open pull requests read from GitHub. */
+		checked: Schema.Number,
+		/** Of those, the ones whose stored fields changed. */
+		updated: Schema.Number,
+		/** Of those, the ones GitHub could not be read for. */
+		failed: Schema.Number
+	}),
+	types: [PullRequest.PullRequest]
+}).pipe(Operation.mutation("write"));
+/** Aggregate outcome of a commit's check runs; `none` when the commit has no checks at all. */
+var CiState = Schema.Literals([
+	"success",
+	"failure",
+	"pending",
+	"none"
+]);
+var CheckCounts = Schema.Struct({
+	total: Schema.Number,
+	passed: Schema.Number,
+	failed: Schema.Number,
+	pending: Schema.Number
+});
+/**
+* Where the reviews stand, from each reviewer's latest verdict: any outstanding request for changes
+* outweighs approvals, and `none` means no reviewer has approved or asked for changes.
+*/
+var ReviewState = Schema.Literals([
+	"approved",
+	"changes_requested",
+	"none"
+]);
+/** How one check run ended, folded to what a reader acts on; `skipped` is neither passing nor failing. */
+var CheckOutcome = Schema.Literals([
+	"success",
+	"failure",
+	"pending",
+	"skipped",
+	"neutral"
+]);
+/** One check run on the head commit, as the article lists it. */
+var CheckRun = Schema.Struct({
+	name: Schema.String,
+	outcome: CheckOutcome,
+	/** GitHub's own `conclusion` (`timed_out`, `cancelled`, …), kept for the label when it says more than the outcome. */
+	conclusion: Schema.String.pipe(Schema.optional),
+	/** Where the run's logs live: the provider's page when it has one, else GitHub's. */
+	url: Schema.String.pipe(Schema.optional),
+	startedAt: Schema.String.pipe(Schema.optional),
+	completedAt: Schema.String.pipe(Schema.optional)
+});
+/** Read a pull request's live state and the CI outcome of its head commit from GitHub. */
+var GetPullRequestStatus = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.getPullRequestStatus"),
+		name: "Get Pull Request Status",
+		description: "Read a pull request's state, its review verdict and the CI status of its head commit.",
+		icon: "ph--git-pull-request--regular"
+	},
+	input: Schema.Struct({ pullRequest: Ref.Ref(PullRequest.PullRequest) }),
+	output: Schema.Struct({
+		state: PullRequest.State,
+		title: Schema.String,
+		commit: Schema.String.pipe(Schema.optional),
+		/** The live description, which may have changed since the pull request was imported. */
+		body: Schema.String.pipe(Schema.optional),
+		ci: CiState,
+		checks: CheckCounts,
+		runs: Schema.Array(CheckRun),
+		review: ReviewState,
+		/** Reviewers whose latest verdict is an approval. */
+		approvals: Schema.Number
+	}),
+	types: [PullRequest.PullRequest]
+});
+/**
+* Read a pull request's whole change as a unified diff, with the head commit it was taken at so a
+* line comment on it anchors to the lines the reader saw.
+*/
+var GetPullRequestDiff = Operation.make({
+	meta: {
+		key: DXN.make("org.dxos.operation.github.getPullRequestDiff"),
+		name: "Get Pull Request Diff",
+		description: "Read a pull request's changed files as a unified diff.",
+		icon: "ph--git-diff--regular"
+	},
+	input: Schema.Struct({ pullRequest: Ref.Ref(PullRequest.PullRequest) }),
+	output: Schema.Struct({
+		commit: Schema.String.pipe(Schema.optional),
+		diff: Schema.String
+	}),
+	types: [PullRequest.PullRequest]
+});
+/**
+* Progress key for {@link GenerateWalkthrough}, derived from the pull request rather than passed, so
+* the UI can watch a run it did not start. The absolute URI form is required: a hydration-dependent
+* one would not match the key the producer mints.
+*/
+var createWalkthroughProgressKey = (pullRequest) => Obj.getURI(pullRequest, { prefer: "absolute" }).toString() + "#walkthrough";
+//#endregion
+export { AddPullRequestComment, AddPullRequestReviewComment, CheckCounts, CheckOutcome, CheckRun, CiState, GenerateWalkthrough, GetGitHubRepositories, GetPullRequestDiff, GetPullRequestStatus, ImportPullRequest, ImportPullRequestFromSnapshot, MaterializeGitHubTarget, RefreshPullRequests, ReviewState, SubmitPullRequestApproval, SyncGitHubRepositories, SyncOptions, SyncPullRequest, createWalkthroughProgressKey, GitHubOperation_exports as t };
+
+//# sourceMappingURL=GitHubOperation.mjs.map

package/dist/lib/GitHubOperation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubOperation.mjs","names":[],"sources":["../../src/types/GitHubOperation.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { AiService } from '@dxos/ai';\nimport * as Operation from '@dxos/compute/Operation';\nimport * as Trace from '@dxos/compute/Trace';\nimport { Database, DXN, Obj, Ref } from '@dxos/echo';\n// Referenced in the emitted .d.ts of the operations (via `ConnectorSpec`'s schemas); importing it\n// lets TypeScript name it (TS2883).\n// eslint-disable-next-line unused-imports/no-unused-imports\nimport { Connection } from '@dxos/link';\nimport * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';\nimport * as PageAction from '@dxos/plugin-crx/PageAction';\nimport { PullRequest } from '@dxos/types';\n\nimport * as Walkthrough from './Walkthrough.ts';\n\n/**\n * Discovery only — list GitHub repositories the connection's token can see.\n * Returns one descriptor per repo across all the user's orgs (and personal\n * account). Read-only: NEVER materializes local objects — materialization is\n * handled by the connector's `materializeTarget` when a `Cursor` is created.\n *\n * Orgs and their members are NOT presented as sync targets — they are\n * auto-synced as part of the sync of any repo they own.\n */\nexport const GetGitHubRepositories = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.getRepositories'),\n    name: 'Get GitHub Repositories',\n    description: 'List GitHub repositories reachable from a connection without materializing local objects.',\n    icon: 'ph--github-logo--regular',\n  },\n  input: ConnectorSpec.GetSyncTargetsInput,\n  output: ConnectorSpec.GetSyncTargetsOutput,\n});\n\n/**\n * Find-or-create the empty local root Project for a selected GitHub repo so a\n * cursor can reference it as its `spec.target`. Keyed by the repo's\n * GitHub foreign id (`remoteTarget.id`), so it is idempotent across re-selection.\n */\nexport const MaterializeGitHubTarget = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.materializeTarget'),\n    name: 'Materialize GitHub Target',\n    description: 'Create the empty local root Project bound to a selected GitHub repository.',\n    icon: 'ph--github-logo--regular',\n  },\n  input: ConnectorSpec.MaterializeTargetInput,\n  output: ConnectorSpec.MaterializeTargetOutput,\n});\n\n/**\n * Per-target options. `maxDaysBack` caps how far back issues/PRs are pulled\n * (mirrors the Gmail mailbox `daysBack`). Default — when unset — is \"sync\n * everything ever opened or edited.\"\n */\nexport const SyncOptions = Schema.Struct({\n  maxDaysBack: Schema.Number.annotate({\n    title: 'Sync history (days)',\n    description: 'Pull issues and PRs updated within this many days. Leave empty to sync everything.',\n  }).pipe(Schema.optional),\n});\n\nexport interface SyncOptions extends Schema.Schema.Type<typeof SyncOptions> {}\n\n/**\n * Reconcile GitHub data for every repo bound to a connection (one cursor per repo).\n *\n * Pull-then-push per bound repo: auto-upsert its owning org + members,\n * three-way merge the repo as a Project and its issues/PRs as Tasks (respecting\n * `maxDaysBack` if set), then push diverged Project/Task fields back to GitHub.\n * Sync state (`lastTick`/`lastError`/`spec.snapshots`) is written onto each binding.\n */\nexport const SyncGitHubRepositories = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.syncRepositories'),\n    name: 'Sync GitHub Repositories',\n    description: 'Reconcile every bound GitHub repo plus its owning org, members, issues, PRs, and comments.',\n    icon: 'ph--arrows-clockwise--regular',\n  },\n  input: ConnectorSpec.SyncInput,\n  output: Schema.Struct({\n    pulled: Schema.Struct({\n      organizations: Schema.Number,\n      people: Schema.Number,\n      projects: Schema.Number,\n      tasks: Schema.Number,\n      comments: Schema.Number,\n    }),\n  }),\n}).pipe(Operation.visible);\n\n/**\n * Import a pull request named by a github.com URL or `owner/repo#123` into the space, so it can be\n * opened, reviewed and walked through without waiting for a sync of the whole repository.\n *\n * Idempotent by coordinates — a pull request the space already holds is returned as it stands\n * rather than duplicated.\n */\nexport const ImportPullRequest = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.importPullRequest'),\n    name: 'Import Pull Request',\n    description: 'Add a pull request to the space, named by its URL or as owner/repo#number.',\n    icon: 'ph--git-pull-request--regular',\n  },\n  services: [Database.Service],\n  input: Schema.Struct({\n    /** A github.com pull request URL, or `owner/repo#123`. */\n    reference: Schema.String,\n  }),\n  output: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n    /** False where the space already held the pull request, which is then returned unchanged. */\n    imported: Schema.Boolean,\n  }),\n  types: [PullRequest.PullRequest],\n}).pipe(Operation.visible, Operation.mutation('write'));\n\n/**\n * Import the pull request the browser extension is looking at, named by the page's own URL.\n *\n * Separate from {@link ImportPullRequest} because the extension bridge invokes every page action\n * with the fixed `{ snapshot, target }` shape and reads an `{ id }` back. Nothing is extracted from\n * the page: the URL in the snapshot's source names the pull request, and GitHub is the authority on\n * everything else.\n */\nexport const ImportPullRequestFromSnapshot = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.importPullRequestFromSnapshot'),\n    name: 'Open pull request in Composer',\n    description: \"Import the pull request a browser page shows, named by that page's URL.\",\n    icon: 'ph--git-pull-request--regular',\n  },\n  input: Schema.Struct({\n    snapshot: PageAction.Snapshot,\n    target: Database.Database.annotate({ description: 'The database to add the pull request to.' }),\n  }),\n  output: Schema.Struct({\n    id: Schema.String,\n  }),\n  types: [PullRequest.PullRequest],\n}).pipe(Operation.mutation('write'));\n\n/**\n * Generate a walkthrough of a pull request: one markdown document narrating the change in reading\n * order, with its diff chunks spliced in from the patch itself.\n *\n * Idempotent by commit — a walkthrough already generated for the pull request's head is returned\n * unchanged unless `force` says otherwise, since the answer cannot have changed.\n */\nexport const GenerateWalkthrough = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.generateWalkthrough'),\n    name: 'Generate Walkthrough',\n    description: \"Narrate a pull request as one markdown document, with the change's diffs embedded in it.\",\n    icon: 'ph--path--regular',\n  },\n  input: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n    /** Regenerate even where a walkthrough for this head already exists. */\n    force: Schema.Boolean.pipe(Schema.optional),\n  }),\n  output: Schema.Struct({\n    walkthrough: Ref.Ref(Walkthrough.Walkthrough),\n    /** Whether the model ran, as against an existing walkthrough being returned unchanged. */\n    generated: Schema.Boolean,\n    /** Hunks the prose accounts for, over the patch's total. */\n    covered: Schema.Number,\n    total: Schema.Number,\n  }),\n  types: [Walkthrough.Walkthrough, PullRequest.PullRequest],\n  // `AiService` must be declared, not merely provided: the invoker builds the runtime from THIS list\n  // and `Layer.orDie` clears a layer's error channel, never its requirement.\n  services: [Trace.TraceService, AiService.AiService],\n}).pipe(Operation.visible);\n\n/**\n * Submit an approving review on a pull request, as the space's GitHub connection.\n *\n * Falls back to a marked conversation comment where GitHub refuses the review — the author's own\n * pull request, or a token with no review permission — so the approval is still recorded and still\n * detectable by an agent deciding whether the pull request is good to land.\n */\nexport const SubmitPullRequestApproval = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.submitPullRequestApproval'),\n    name: 'Submit Pull Request Approval',\n    description: 'Submit an approving review on a pull request, or record the approval as a comment.',\n    icon: 'ph--check-circle--regular',\n  },\n  input: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n    /** Optional review summary. */\n    body: Schema.String.pipe(Schema.optional),\n  }),\n  output: Schema.Struct({\n    /** Set where the approving review was accepted. */\n    reviewId: Schema.Number.pipe(Schema.optional),\n    /** Set instead where the approval was recorded as a comment. */\n    commentId: Schema.Number.pipe(Schema.optional),\n    url: Schema.String.pipe(Schema.optional),\n    /** Whether the approval is a comment rather than a review. */\n    commented: Schema.Boolean,\n  }),\n  types: [PullRequest.PullRequest],\n});\n\n/** Post a conversation comment on a pull request, as the space's GitHub connection. */\nexport const AddPullRequestComment = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.addPullRequestComment'),\n    name: 'Add Pull Request Comment',\n    description: 'Post a comment on a pull request.',\n    icon: 'ph--chat-text--regular',\n  },\n  input: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n    body: Schema.String,\n  }),\n  output: Schema.Struct({\n    commentId: Schema.Number,\n    url: Schema.String.pipe(Schema.optional),\n  }),\n  types: [PullRequest.PullRequest],\n});\n\n/** Post a review comment on one line of a pull request's diff, as the space's GitHub connection. */\nexport const AddPullRequestReviewComment = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.addPullRequestReviewComment'),\n    name: 'Add Pull Request Review Comment',\n    description: 'Post a review comment on a line of a pull request diff.',\n    icon: 'ph--chat-centered-text--regular',\n  },\n  input: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n    body: Schema.String,\n    /** Head SHA the line numbers refer to; a walkthrough's `commit`. */\n    commit: Schema.String,\n    path: Schema.String,\n    line: Schema.Number,\n    /** `LEFT` for the removed side, `RIGHT` for added and context lines. */\n    side: Schema.Literals(['LEFT', 'RIGHT']),\n  }),\n  output: Schema.Struct({\n    commentId: Schema.Number,\n    url: Schema.String.pipe(Schema.optional),\n  }),\n  types: [PullRequest.PullRequest],\n});\n\n/**\n * Re-read a stored pull request from GitHub and write back whatever has changed — its title, state,\n * description, branches and size — so the object in the space does not go stale between syncs.\n */\nexport const SyncPullRequest = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.syncPullRequest'),\n    name: 'Sync Pull Request',\n    description: 'Refresh a stored pull request from GitHub.',\n    icon: 'ph--arrows-clockwise--regular',\n  },\n  input: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n  }),\n  output: Schema.Struct({\n    /** Names of the fields that changed; empty where the stored pull request was already current. */\n    updated: Schema.Array(Schema.String),\n  }),\n  types: [PullRequest.PullRequest],\n}).pipe(Operation.mutation('write'));\n\n/**\n * Refresh every pull request in the space that is still in flight (open or draft) from GitHub.\n *\n * Run on a schedule by the space's refresh trigger (see `ensureRefreshTrigger`), so pull requests the\n * user is not looking at still track their state; one unreachable pull request does not fail the rest.\n */\nexport const RefreshPullRequests = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.refreshPullRequests'),\n    name: 'Refresh Pull Requests',\n    description: 'Refresh every open pull request in the space from GitHub.',\n    icon: 'ph--arrows-clockwise--regular',\n  },\n  services: [Database.Service],\n  input: Schema.Struct({}),\n  output: Schema.Struct({\n    /** Open pull requests read from GitHub. */\n    checked: Schema.Number,\n    /** Of those, the ones whose stored fields changed. */\n    updated: Schema.Number,\n    /** Of those, the ones GitHub could not be read for. */\n    failed: Schema.Number,\n  }),\n  types: [PullRequest.PullRequest],\n}).pipe(Operation.mutation('write'));\n\n/** Aggregate outcome of a commit's check runs; `none` when the commit has no checks at all. */\nexport const CiState = Schema.Literals(['success', 'failure', 'pending', 'none']);\nexport type CiState = Schema.Schema.Type<typeof CiState>;\n\nexport const CheckCounts = Schema.Struct({\n  total: Schema.Number,\n  passed: Schema.Number,\n  failed: Schema.Number,\n  pending: Schema.Number,\n});\nexport interface CheckCounts extends Schema.Schema.Type<typeof CheckCounts> {}\n\n/**\n * Where the reviews stand, from each reviewer's latest verdict: any outstanding request for changes\n * outweighs approvals, and `none` means no reviewer has approved or asked for changes.\n */\nexport const ReviewState = Schema.Literals(['approved', 'changes_requested', 'none']);\nexport type ReviewState = Schema.Schema.Type<typeof ReviewState>;\n\n/** How one check run ended, folded to what a reader acts on; `skipped` is neither passing nor failing. */\nexport const CheckOutcome = Schema.Literals(['success', 'failure', 'pending', 'skipped', 'neutral']);\nexport type CheckOutcome = Schema.Schema.Type<typeof CheckOutcome>;\n\n/** One check run on the head commit, as the article lists it. */\nexport const CheckRun = Schema.Struct({\n  name: Schema.String,\n  outcome: CheckOutcome,\n  /** GitHub's own `conclusion` (`timed_out`, `cancelled`, …), kept for the label when it says more than the outcome. */\n  conclusion: Schema.String.pipe(Schema.optional),\n  /** Where the run's logs live: the provider's page when it has one, else GitHub's. */\n  url: Schema.String.pipe(Schema.optional),\n  startedAt: Schema.String.pipe(Schema.optional),\n  completedAt: Schema.String.pipe(Schema.optional),\n});\nexport interface CheckRun extends Schema.Schema.Type<typeof CheckRun> {}\n\n/** Read a pull request's live state and the CI outcome of its head commit from GitHub. */\nexport const GetPullRequestStatus = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.getPullRequestStatus'),\n    name: 'Get Pull Request Status',\n    description: \"Read a pull request's state, its review verdict and the CI status of its head commit.\",\n    icon: 'ph--git-pull-request--regular',\n  },\n  input: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n  }),\n  output: Schema.Struct({\n    state: PullRequest.State,\n    title: Schema.String,\n    commit: Schema.String.pipe(Schema.optional),\n    /** The live description, which may have changed since the pull request was imported. */\n    body: Schema.String.pipe(Schema.optional),\n    ci: CiState,\n    checks: CheckCounts,\n    runs: Schema.Array(CheckRun),\n    review: ReviewState,\n    /** Reviewers whose latest verdict is an approval. */\n    approvals: Schema.Number,\n  }),\n  types: [PullRequest.PullRequest],\n});\n\n/**\n * Read a pull request's whole change as a unified diff, with the head commit it was taken at so a\n * line comment on it anchors to the lines the reader saw.\n */\nexport const GetPullRequestDiff = Operation.make({\n  meta: {\n    key: DXN.make('org.dxos.operation.github.getPullRequestDiff'),\n    name: 'Get Pull Request Diff',\n    description: \"Read a pull request's changed files as a unified diff.\",\n    icon: 'ph--git-diff--regular',\n  },\n  input: Schema.Struct({\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n  }),\n  output: Schema.Struct({\n    commit: Schema.String.pipe(Schema.optional),\n    diff: Schema.String,\n  }),\n  types: [PullRequest.PullRequest],\n});\n\n/**\n * Progress key for {@link GenerateWalkthrough}, derived from the pull request rather than passed, so\n * the UI can watch a run it did not start. The absolute URI form is required: a hydration-dependent\n * one would not match the key the producer mints.\n */\nexport const createWalkthroughProgressKey = (pullRequest: PullRequest.PullRequest): string =>\n  Obj.getURI(pullRequest, { prefer: 'absolute' }).toString() + '#walkthrough';\n"],"mappings":"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"}

package/dist/lib/GitHubPlugin.mjs

@@ -0,0 +1,16 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { meta as meta$1 } from "#meta";
+import * as Plugin from "@dxos/app-framework/Plugin";
+//#region src/GitHubPlugin.ts
+var GitHubPlugin_exports = /* @__PURE__ */ __exportAll({
+	make: () => make,
+	meta: () => meta
+});
+/** Plugin metadata, available without loading the plugin body. */
+var meta = meta$1;
+/** Constructs the plugin; the body loads on first enable. */
+var make = Plugin.lazy(meta, () => import("#plugin"));
+//#endregion
+export { make, meta, GitHubPlugin_exports as t };
+
+//# sourceMappingURL=GitHubPlugin.mjs.map

package/dist/lib/GitHubPlugin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubPlugin.mjs","names":[],"sources":["../../src/GitHubPlugin.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Plugin from '@dxos/app-framework/Plugin';\n\nimport { meta as pluginMeta } from '#meta';\n\n/** Plugin metadata, available without loading the plugin body. */\nexport const meta = pluginMeta;\n\n/** Constructs the plugin; the body loads on first enable. */\nexport const make = Plugin.lazy(meta, () => import('#plugin'));\n"],"mappings":";;;;;;;;;AAWA,IAAa,OAAO;;AAGpB,IAAa,OAAO,OAAO,KAAK,YAAY,OAAO,UAAU"}

package/dist/lib/Walkthrough.mjs

@@ -0,0 +1,59 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import { PullRequest } from "@dxos/types";
+import { Annotation, DXN, Format, Obj, Ref, Type } from "@dxos/echo";
+import * as Schema from "effect/Schema";
+//#region src/types/Walkthrough.ts
+var Walkthrough_exports = /* @__PURE__ */ __exportAll({
+	Walkthrough: () => Walkthrough,
+	instanceOf: () => instanceOf,
+	isStale: () => isStale,
+	make: () => make,
+	makeTitle: () => makeTitle
+});
+/**
+* A narrated reading of a pull request: one markdown document whose prose, headings and ```diff
+* fences describe the change in the order a reviewer should meet it.
+*
+* Generated against ONE commit and stale the moment the branch moves, which is why `commit` is part
+* of the record rather than something to infer — see {@link isStale}.
+*/
+var Walkthrough = class extends Type.makeObject(DXN.make("org.dxos.type.walkthrough", "0.1.0"))(Schema.Struct({
+	/** The pull request this narrates. */
+	pullRequest: Ref.Ref(PullRequest.PullRequest),
+	/** `owner/repo#123: title`, copied at generation so the label needs no ref load. */
+	title: Schema.String.pipe(Schema.annotate({ title: "Title" }), Schema.optional),
+	/**
+	* The whole document, as a plain string rather than a text object.
+	*
+	* A walkthrough is replaced wholesale on every regeneration and is never co-edited character by
+	* character, so the CRDT a text object would impose is pure cost: it would keep per-character
+	* history for a document nobody edits.
+	*/
+	body: Schema.String.pipe(Schema.annotate({ title: "Body" })),
+	/** Head SHA the walkthrough was generated from; anything else means it describes another change. */
+	commit: Schema.String.pipe(Schema.annotate({ title: "Commit" })),
+	generatedAt: Format.DateTime.pipe(Schema.annotate({ title: "Generated" }), Schema.optional),
+	/** Model that produced the prose, so a regression can be attributed after the default moves. */
+	model: Schema.String.pipe(Schema.annotate({ title: "Model" }), Schema.optional),
+	/** Hunks the prose accounts for, over the patch's total — how much of the change it narrates. */
+	covered: Schema.Number.pipe(Schema.annotate({ title: "Hunks covered" }), Schema.optional),
+	total: Schema.Number.pipe(Schema.annotate({ title: "Hunks total" }), Schema.optional)
+}).pipe(Schema.annotate({
+	title: "Walkthrough",
+	description: "A narrated reading of a pull request."
+}), Annotation.LabelAnnotation.set(["title", "commit"]), Annotation.IconAnnotation.set({
+	icon: "ph--path--regular",
+	hue: "indigo"
+}), Annotation.UserType.set())) {};
+/** Factory wrapper around `Obj.make` for {@link Walkthrough}. */
+var make = (props) => Obj.make(Walkthrough, props);
+/** Returns true when value is a Walkthrough object. */
+var instanceOf = (value) => Obj.instanceOf(Walkthrough, value);
+/** The label a walkthrough of this pull request carries. */
+var makeTitle = (pullRequest, title = pullRequest.title) => `${PullRequest.reference(pullRequest)}: ${title}`;
+/** Whether the walkthrough describes a commit other than the one given. */
+var isStale = (walkthrough, head) => walkthrough.commit !== head;
+//#endregion
+export { Walkthrough, instanceOf, isStale, make, makeTitle, Walkthrough_exports as t };
+
+//# sourceMappingURL=Walkthrough.mjs.map

package/dist/lib/Walkthrough.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Walkthrough.mjs","names":[],"sources":["../../src/types/Walkthrough.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Schema from 'effect/Schema';\n\nimport { Annotation, DXN, Format, Obj, Ref, Type } from '@dxos/echo';\nimport { PullRequest } from '@dxos/types';\n\n/**\n * A narrated reading of a pull request: one markdown document whose prose, headings and ```diff\n * fences describe the change in the order a reviewer should meet it.\n *\n * Generated against ONE commit and stale the moment the branch moves, which is why `commit` is part\n * of the record rather than something to infer — see {@link isStale}.\n */\nexport class Walkthrough extends Type.makeObject<Walkthrough>(DXN.make('org.dxos.type.walkthrough', '0.1.0'))(\n  Schema.Struct({\n    /** The pull request this narrates. */\n    pullRequest: Ref.Ref(PullRequest.PullRequest),\n\n    /** `owner/repo#123: title`, copied at generation so the label needs no ref load. */\n    title: Schema.String.pipe(Schema.annotate({ title: 'Title' }), Schema.optional),\n\n    /**\n     * The whole document, as a plain string rather than a text object.\n     *\n     * A walkthrough is replaced wholesale on every regeneration and is never co-edited character by\n     * character, so the CRDT a text object would impose is pure cost: it would keep per-character\n     * history for a document nobody edits.\n     */\n    body: Schema.String.pipe(Schema.annotate({ title: 'Body' })),\n\n    /** Head SHA the walkthrough was generated from; anything else means it describes another change. */\n    commit: Schema.String.pipe(Schema.annotate({ title: 'Commit' })),\n\n    generatedAt: Format.DateTime.pipe(Schema.annotate({ title: 'Generated' }), Schema.optional),\n\n    /** Model that produced the prose, so a regression can be attributed after the default moves. */\n    model: Schema.String.pipe(Schema.annotate({ title: 'Model' }), Schema.optional),\n\n    /** Hunks the prose accounts for, over the patch's total — how much of the change it narrates. */\n    covered: Schema.Number.pipe(Schema.annotate({ title: 'Hunks covered' }), Schema.optional),\n    total: Schema.Number.pipe(Schema.annotate({ title: 'Hunks total' }), Schema.optional),\n  }).pipe(\n    Schema.annotate({ title: 'Walkthrough', description: 'A narrated reading of a pull request.' }),\n    Annotation.LabelAnnotation.set(['title', 'commit']),\n    Annotation.IconAnnotation.set({ icon: 'ph--path--regular', hue: 'indigo' }),\n    Annotation.UserType.set(),\n  ),\n) {}\n\n/** Factory wrapper around `Obj.make` for {@link Walkthrough}. */\nexport const make = (props: Obj.MakeProps<typeof Walkthrough>): Walkthrough => Obj.make(Walkthrough, props);\n\n/** Returns true when value is a Walkthrough object. */\nexport const instanceOf = (value: unknown): value is Walkthrough => Obj.instanceOf(Walkthrough, value);\n\n/** The label a walkthrough of this pull request carries. */\nexport const makeTitle = (pullRequest: PullRequest.PullRequest, title = pullRequest.title): string =>\n  `${PullRequest.reference(pullRequest)}: ${title}`;\n\n/** Whether the walkthrough describes a commit other than the one given. */\nexport const isStale = (walkthrough: Walkthrough, head: string): boolean => walkthrough.commit !== head;\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAkBA,IAAa,cAAb,cAAiC,KAAK,WAAwB,IAAI,KAAK,6BAA6B,OAAO,CAAC,CAAC,CAC3G,OAAO,OAAO;;CAEZ,aAAa,IAAI,IAAI,YAAY,WAAW;;CAG5C,OAAO,OAAO,OAAO,KAAK,OAAO,SAAS,EAAE,OAAO,QAAQ,CAAC,GAAG,OAAO,QAAQ;;;;;;;;CAS9E,MAAM,OAAO,OAAO,KAAK,OAAO,SAAS,EAAE,OAAO,OAAO,CAAC,CAAC;;CAG3D,QAAQ,OAAO,OAAO,KAAK,OAAO,SAAS,EAAE,OAAO,SAAS,CAAC,CAAC;CAE/D,aAAa,OAAO,SAAS,KAAK,OAAO,SAAS,EAAE,OAAO,YAAY,CAAC,GAAG,OAAO,QAAQ;;CAG1F,OAAO,OAAO,OAAO,KAAK,OAAO,SAAS,EAAE,OAAO,QAAQ,CAAC,GAAG,OAAO,QAAQ;;CAG9E,SAAS,OAAO,OAAO,KAAK,OAAO,SAAS,EAAE,OAAO,gBAAgB,CAAC,GAAG,OAAO,QAAQ;CACxF,OAAO,OAAO,OAAO,KAAK,OAAO,SAAS,EAAE,OAAO,cAAc,CAAC,GAAG,OAAO,QAAQ;AACtF,CAAC,CAAC,CAAC,KACD,OAAO,SAAS;CAAE,OAAO;CAAe,aAAa;AAAwC,CAAC,GAC9F,WAAW,gBAAgB,IAAI,CAAC,SAAS,QAAQ,CAAC,GAClD,WAAW,eAAe,IAAI;CAAE,MAAM;CAAqB,KAAK;AAAS,CAAC,GAC1E,WAAW,SAAS,IAAI,CAC1B,CACF,CAAC,CAAC,CAAC;;AAGH,IAAa,QAAQ,UAA0D,IAAI,KAAK,aAAa,KAAK;;AAG1G,IAAa,cAAc,UAAyC,IAAI,WAAW,aAAa,KAAK;;AAGrG,IAAa,aAAa,aAAsC,QAAQ,YAAY,UAClF,GAAG,YAAY,UAAU,WAAW,EAAE,IAAI;;AAG5C,IAAa,WAAW,aAA0B,SAA0B,YAAY,WAAW"}

package/dist/lib/capabilities.browser.mjs

@@ -0,0 +1,54 @@
+import { t as PLUGIN_default } from "./chunk-PLUGIN.mjs";
+import * as ActivationEvents from "@dxos/app-framework/ActivationEvents";
+import * as Capability from "@dxos/app-framework/Capability";
+import * as AppCapability from "@dxos/app-toolkit/AppCapability";
+import * as ConnectorEvents from "@dxos/plugin-connector/ConnectorEvents";
+import * as ConnectorSpec from "@dxos/plugin-connector/ConnectorSpec";
+import * as CrxCapabilities from "@dxos/plugin-crx/CrxCapabilities";
+import * as CrxEvents from "@dxos/plugin-crx/CrxEvents";
+import { translations } from "#translations";
+import * as MarkdownCapabilities from "@dxos/plugin-markdown/MarkdownCapabilities";
+import * as MarkdownEvents from "@dxos/plugin-markdown/MarkdownEvents";
+import * as PreviewCapabilities from "@dxos/plugin-preview/PreviewCapabilities";
+import * as PreviewEvents from "@dxos/plugin-preview/PreviewEvents";
+import { meta } from "#meta";
+//#region src/capabilities/gen/browser.ts
+var Connector = Capability.lazyModule("GitHubConnector", {
+	provides: [ConnectorSpec.Connector],
+	activatesOn: ConnectorEvents.Start
+}, () => import("./chunk-connector.mjs"));
+var MarkdownExtension = Capability.lazyModule("MarkdownExtension", {
+	provides: [MarkdownCapabilities.ExtensionProvider],
+	activatesOn: MarkdownEvents.Start,
+	environments: ["browser", "tauri"]
+}, () => import("./chunk-markdown-extension.mjs"));
+var LinkResolver = Capability.lazyModule("LinkResolver", {
+	provides: [PreviewCapabilities.LinkResolver],
+	activatesOn: PreviewEvents.Start,
+	environments: ["browser", "tauri"]
+}, () => import("./chunk-link-resolver.mjs"));
+var AppGraphBuilder = AppCapability.appGraphBuilder(() => import("./chunk-app-graph-builder.mjs"), { environments: ["browser", "tauri"] });
+var PageActionProvider = Capability.lazyModule("PageActionProvider", {
+	provides: [CrxCapabilities.PageAction],
+	activatesOn: CrxEvents.Start
+}, () => import("./chunk-page-action.mjs"));
+var OperationHandler = AppCapability.operationHandler(() => import("./chunk-operation-handler.mjs"), { activatesOn: ActivationEvents.Idle });
+var Schema = AppCapability.schema(() => import("./chunk-schema.mjs"));
+var SkillDefinition = AppCapability.skillDefinition(() => import("./chunk-skill-definition.mjs"));
+var ReactSurface = AppCapability.surface(() => import("./chunk-react-surface.mjs").then((n) => n.t), { roles: [
+	"org.dxos.role.cardContent",
+	"org.dxos.role.cardMenu",
+	"org.dxos.role.article",
+	"org.dxos.role.dialog"
+] });
+var PluginAsset = AppCapability.pluginAsset({
+	pluginId: meta.profile.key,
+	path: "PLUGIN.mdl",
+	content: PLUGIN_default,
+	mimeType: "application/x-mdl"
+});
+var Translations = AppCapability.translations(translations);
+//#endregion
+export { AppGraphBuilder, Connector, LinkResolver, MarkdownExtension, OperationHandler, PageActionProvider, PluginAsset, ReactSurface, Schema, SkillDefinition, Translations };
+
+//# sourceMappingURL=capabilities.browser.mjs.map

package/dist/lib/capabilities.browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.browser.mjs","names":[],"sources":["../../src/capabilities/gen/browser.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\n// GENERATED by dx-plugin — do not edit. Sliced from ../index.ts for the 'browser' condition.\n\nimport * as ActivationEvents from '@dxos/app-framework/ActivationEvents';\nimport * as Capability from '@dxos/app-framework/Capability';\nimport * as AppCapability from '@dxos/app-toolkit/AppCapability';\nimport * as ConnectorEvents from '@dxos/plugin-connector/ConnectorEvents';\nimport * as ConnectorSpec from '@dxos/plugin-connector/ConnectorSpec';\nimport * as CrxCapabilities from '@dxos/plugin-crx/CrxCapabilities';\nimport * as CrxEvents from '@dxos/plugin-crx/CrxEvents';\nimport * as MarkdownCapabilities from '@dxos/plugin-markdown/MarkdownCapabilities';\nimport * as MarkdownEvents from '@dxos/plugin-markdown/MarkdownEvents';\nimport * as PreviewCapabilities from '@dxos/plugin-preview/PreviewCapabilities';\nimport * as PreviewEvents from '@dxos/plugin-preview/PreviewEvents';\n\nimport { meta } from '#meta';\nimport { translations } from '#translations';\n\nimport pluginSpec from '../../../PLUGIN.mdl?raw';\n\nexport const Connector = Capability.lazyModule(\n  'GitHubConnector',\n  { provides: [ConnectorSpec.Connector], activatesOn: ConnectorEvents.Start },\n  () => import('../connector.ts'),\n);\n\n// Browser-only: the editor it decorates and the popover it answers render nowhere else.\nexport const MarkdownExtension = Capability.lazyModule(\n  'MarkdownExtension',\n  {\n    provides: [MarkdownCapabilities.ExtensionProvider],\n    activatesOn: MarkdownEvents.Start,\n    environments: ['browser', 'tauri'],\n  },\n  () => import('../markdown-extension.ts'),\n);\n\nexport const LinkResolver = Capability.lazyModule(\n  'LinkResolver',\n  {\n    provides: [PreviewCapabilities.LinkResolver],\n    activatesOn: PreviewEvents.Start,\n    environments: ['browser', 'tauri'],\n  },\n  () => import('../link-resolver.ts'),\n);\n\n// Narrower than the `appGraphBuilder` family default: the action opens a dialog, which means\n// nothing without an app shell.\nexport const AppGraphBuilder = AppCapability.appGraphBuilder(() => import('../app-graph-builder.ts'), {\n  environments: ['browser', 'tauri'],\n});\n\nexport const PageActionProvider = Capability.lazyModule(\n  'PageActionProvider',\n  { provides: [CrxCapabilities.PageAction], activatesOn: CrxEvents.Start },\n  () => import('../page-action.ts'),\n);\n\nexport const OperationHandler = AppCapability.operationHandler(() => import('../operation-handler.ts'), {\n  activatesOn: ActivationEvents.Idle,\n});\n\nexport const Schema = AppCapability.schema(() => import('../schema.ts'));\n\nexport const SkillDefinition = AppCapability.skillDefinition(() => import('../skill-definition.ts'));\n\nexport const ReactSurface = AppCapability.surface(() => import('../react-surface.ts'), {\n  roles: ['org.dxos.role.cardContent', 'org.dxos.role.cardMenu', 'org.dxos.role.article', 'org.dxos.role.dialog'],\n});\n\nexport const PluginAsset = AppCapability.pluginAsset({\n  pluginId: meta.profile.key,\n  path: 'PLUGIN.mdl',\n  content: pluginSpec,\n  mimeType: 'application/x-mdl',\n});\n\nexport const Translations = AppCapability.translations(translations);\n"],"mappings":";;;;;;;;;;;;;;;AAuBA,IAAa,YAAY,WAAW,WAClC,mBACA;CAAE,UAAU,CAAC,cAAc,SAAS;CAAG,aAAa,gBAAgB;AAAM,SACpE,OAAO,wBACf;AAGA,IAAa,oBAAoB,WAAW,WAC1C,qBACA;CACE,UAAU,CAAC,qBAAqB,iBAAiB;CACjD,aAAa,eAAe;CAC5B,cAAc,CAAC,WAAW,OAAO;AACnC,SACM,OAAO,iCACf;AAEA,IAAa,eAAe,WAAW,WACrC,gBACA;CACE,UAAU,CAAC,oBAAoB,YAAY;CAC3C,aAAa,cAAc;CAC3B,cAAc,CAAC,WAAW,OAAO;AACnC,SACM,OAAO,4BACf;AAIA,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,kCAA4B,EACpG,cAAc,CAAC,WAAW,OAAO,EACnC,CAAC;AAED,IAAa,qBAAqB,WAAW,WAC3C,sBACA;CAAE,UAAU,CAAC,gBAAgB,UAAU;CAAG,aAAa,UAAU;AAAM,SACjE,OAAO,0BACf;AAEA,IAAa,mBAAmB,cAAc,uBAAuB,OAAO,kCAA4B,EACtG,aAAa,iBAAiB,KAChC,CAAC;AAED,IAAa,SAAS,cAAc,aAAa,OAAO,qBAAe;AAEvE,IAAa,kBAAkB,cAAc,sBAAsB,OAAO,+BAAyB;AAEnG,IAAa,eAAe,cAAc,cAAc,OAAO,4BAAA,CAAA,MAAA,MAAA,EAAA,CAAA,GAAwB,EACrF,OAAO;CAAC;CAA6B;CAA0B;CAAyB;AAAsB,EAChH,CAAC;AAED,IAAa,cAAc,cAAc,YAAY;CACnD,UAAU,KAAK,QAAQ;CACvB,MAAM;CACN,SAAS;CACT,UAAU;AACZ,CAAC;AAED,IAAa,eAAe,cAAc,aAAa,YAAY"}