@openagt/dashboard 0.8.0 → 0.10.0

package/dist/module-types/src/store/agent-store.d.ts

@@ -1,9 +1,9 @@
-import type { FrameworkEvent } from '../events.js';
+import type { OpenAgentEvent } from '../events.js';
 import { type BranchesFor, type Checkout } from './branches.js';
 import { type AnyDiaryLine, type RunsFor } from './runs.js';
 /**
  * The read side of a project's runs (#1774). The daemon runs no agent and writes no run: a run's
- * tool keeps the run's card (`<id>.json`) and diary (`<id>.jsonl`) under the `.the-framework/`
+ * tool keeps the run's card (`<id>.json`) and diary (`<id>.jsonl`) under the `.openagent/`
  * of the run's own checkout while it works, and a finished run is whatever the project's runs
  * provider answers (`runs.ts`), when one of its packages provides them. The dashboard is a
  * projection of those files and that answer.
@@ -195,8 +195,8 @@ export interface StoreFs {
     readdir(path: string): Promise<string[]>;
 }
 /**
- * A project's finished runs, most-recent first: what its runs provider answers, unfolded into the
- * framework's meta. No provider, or one that cannot be read, is no runs, never a throw.
+ * A project's finished runs, most-recent first: what its runs provider answers, unfolded into
+ * OpenAgent's meta. No provider, or one that cannot be read, is no runs, never a throw.
  *
  * `since` (epoch ms) is for a caller that only wants recent runs — a poll on a cadence, not the
  * history list. `fresh` asks the provider past its last answer: the caller knows a run just finished.
@@ -221,7 +221,7 @@ export declare function readFinishedDiary(cwd: string, agentId: string, runs?: R
  */
 export declare function isPidAlive(pid: number): boolean;
 /**
- * The run a checkout holds, off its live card, `<id>.json` under the checkout's `.the-framework/`:
+ * The run a checkout holds, off its live card, `<id>.json` under the checkout's `.openagent/`:
  * the shape agent-driver's log writes, read as the meta the card unfolds to, `running` or not (a
  * run that ended waiting on a question keeps its checkout), on the branch the checkout is on now
  * (the provider read it), since the agent renames its branch itself while its card learns the new
@@ -245,7 +245,7 @@ export declare function readLiveMetas(cwd: string, fs?: StoreFs, branches?: Bran
  * one (it is the newer of the two), else the finished run's diary from the runs provider.
  * `undefined` for an unknown or unsafe id.
  */
-export declare function loadAgentEvents(cwd: string, id: string, fs?: StoreFs, runs?: RunsFor, branches?: BranchesFor): Promise<FrameworkEvent[] | undefined>;
+export declare function loadAgentEvents(cwd: string, id: string, fs?: StoreFs, runs?: RunsFor, branches?: BranchesFor): Promise<OpenAgentEvent[] | undefined>;
 /**
  * What each of the named runs is doing now, by id: the last thing its diary says it did (a tool
  * it used, with what) or said, on one line. Only a run with a checkout whose card says `running`

package/dist/module-types/src/store/branches.d.ts

@@ -1,8 +1,8 @@
 /**
- * The checkouts and the branches, as the framework reads and acts on them (#1774). The framework
+ * The checkouts and the branches, as OpenAgent reads and acts on them (#1774). OpenAgent
  * keeps no checkout and imports no branches package: a project's checkouts come from whichever of
- * its packages declares that it provides them — `"framework": { "branches": "<command>" }` in the
- * package's own package.json — and the framework reads and moves them by running that command.
+ * its packages declares that it provides them — `"openagent": { "branches": "<command>" }` in the
+ * package's own package.json — and OpenAgent reads and moves them by running that command.
  * Swap the package for another that answers the same command line and prints the same shapes,
  * and nothing here changes. No package declares it: the project has no checkouts, so no run with
  * one, no branch to hand off, nothing to remove.
@@ -16,10 +16,10 @@
  *   `<command> merge <b>`                               merge the branch into the default branch, on this machine, then delete it
  *   `<command> push --branch <b>`                       push the branch to the remote; a branch only the remote has is answered as it is
  *   `<command> remove <id> [--from <commit>] [--discard]`  reclaim a run's checkout once its branch holds everything, pushing nothing, its branch measured from the commit it started from; `--discard` drops uncommitted work
- * `list` and `show` read this machine, no network: the framework polls. `show` answers the branch's
+ * `list` and `show` read this machine, no network: OpenAgent polls. `show` answers the branch's
  * git facts only; its pull request is the git host provider's (`git-host.ts`), as every pull request is.
  *
- * That is the whole contract: git, and nothing beyond it (#1820). The framework reads checkouts to
+ * That is the whole contract: git, and nothing beyond it (#1820). OpenAgent reads checkouts to
  * find the runs that have one, and a branch's state for what it composes: the run page's handoff,
  * the Human Queue's unpushed rows. Opening a pull request is the push here, then the git host
  * provider's `open`. What a checkout is, where it lives, how a branch is pushed is the package's.
@@ -105,7 +105,7 @@ export type RemoveOutcome = {
     ok: false;
     error: string;
 };
-/** A project's checkouts and branches: what a provider answers, read and moved by the framework. */
+/** A project's checkouts and branches: what a provider answers, read and moved by OpenAgent. */
 export interface BranchesSource {
     /**
      * Every checkout; `[]` when none can be read. `fresh` asks past a list read within the window:
@@ -149,7 +149,7 @@ export declare function parseCheckouts(output: unknown): Checkout[];
 /** The states read back from a provider's `show`: the objects with a branch and the three verdicts, lists cleaned; anything else is no state. */
 export declare function parseBranchStates(output: unknown): BranchState[];
 /**
- * The production {@link BranchesReader}: the project's provider, looked up by its package.json,
+ * The production {@link BranchesReader}: the project's provider, looked up among the packages the project has (`built-in.ts`),
  * one source per project kept while the same command provides — so the cache holds across the
  * many reads of one poll, and a project that installs, swaps or drops its provider is read the new
  * way within {@link CACHE_MS}. `changed(root)` forgets that project's reads, so the next read runs
@@ -157,7 +157,7 @@ export declare function parseBranchStates(output: unknown): BranchState[];
  * have come or gone.
  */
 export declare function providedBranches(now?: () => number): BranchesReader;
-/** The framework's one reader of the checkouts, shared by every caller so they share its cache. */
+/** OpenAgent's one reader of the checkouts, shared by every caller so they share its cache. */
 export declare const projectBranches: BranchesReader;
 /** A {@link BranchesFor} for a project with no provider: no checkouts. */
 export declare const noBranches: BranchesFor;

package/dist/module-types/src/store/git-host.d.ts

@@ -1,9 +1,9 @@
 /**
- * The project's git host, as the framework reads and acts on it (#1820): the pull requests of the
- * project, opening one, landing one, and the project's page there. The framework names no git host
+ * The project's git host, as OpenAgent reads and acts on it (#1820): the pull requests of the
+ * project, opening one, landing one, and the project's page there. OpenAgent names no git host
  * and runs no git host tool: a project's git host comes from whichever of its packages declares that it
- * provides it — `"framework": { "git-host": "<command>" }` in the package's own package.json — and
- * the framework asks by running that command. Swap the package for another that answers the same
+ * provides it — `"openagent": { "git-host": "<command>" }` in the package's own package.json — and
+ * OpenAgent asks by running that command. Swap the package for another that answers the same
  * command line and prints the same shapes, and nothing here changes. No package declares it: the
  * project has no git host, so no pull requests, and a finished run's last step is the push. A
  * built-in package's git host is the project's only when it answers the project's page there: a
@@ -18,7 +18,7 @@
  *   `<command> merge <number>`                          land the pull request: armed to merge on green, or merged at once
  *   `<command> home`                                    the project's page on the git host, and the git host's name
  * The branch `open` is asked for must already be on the remote: pushing is the branches
- * provider's step, and the framework runs it first.
+ * provider's step, and OpenAgent runs it first.
  *
  * The shapes, owned here: {@link GitHostRequest}, {@link GitHostHome}.
  */
@@ -73,7 +73,7 @@ export type MergeOutcome = {
     ok: false;
     error: string;
 };
-/** A project's git host: what a provider answers, read and moved by the framework. */
+/** A project's git host: what a provider answers, read and moved by OpenAgent. */
 export interface GitHostSource {
     /** The project's pull requests, newest first: all, or one branch's, or by state, or since a time. */
     requests(opts?: {
@@ -101,13 +101,13 @@ export type GitHostReader = GitHostFor & {
 /** The rows read back from a provider's `requests`: the objects with the facts a request needs; anything else is no request. */
 export declare function parseRequests(output: unknown): GitHostRequest[];
 /**
- * The production {@link GitHostReader}: the project's provider, looked up by its package.json, one
+ * The production {@link GitHostReader}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides, so a project that installs, swaps or
  * drops its git host is read the new way within {@link CACHE_MS}. `changed(root)` forgets the
  * project, so the next ask looks its provider up again.
  */
 export declare function providedGitHost(now?: () => number): GitHostReader;
-/** The framework's one reader of the git host, shared by every caller. */
+/** OpenAgent's one reader of the git host, shared by every caller. */
 export declare const projectGitHost: GitHostReader;
 /** A {@link GitHostFor} for a project with no git host package. */
 export declare const noGitHost: GitHostFor;

package/dist/module-types/src/store/provided.d.ts

@@ -1,11 +1,11 @@
 /**
  * A package's command just ran in the project at `root` (a module's, through the dashboard), and
- * may have written what one of the framework's provided readers caches: every provided reader
- * forgets that project, so its next read runs the provider again. The framework never knows which
+ * may have written what one of OpenAgent's provided readers caches: every provided reader
+ * forgets that project, so its next read runs the provider again. OpenAgent never knows which
  * command writes what; forgetting is cheap and re-reading is what it does anyway.
  */
 export declare function providedDataChanged(root: string): void;
-/** The kinds of the framework's data a project's package may provide, one reader each (`git-host` is `git-host.ts`). */
+/** The kinds of OpenAgent's data a project's package may provide, one reader each (`git-host` is `git-host.ts`). */
 export declare const PROVIDED_KINDS: readonly ['tickets', 'queue', 'runs', 'branches', 'git-host', 'repository'];
 /**
  * Why a kind of the project's data has no provider although packages declare it (#1820): two or

package/dist/module-types/src/store/queue.d.ts

@@ -1,24 +1,24 @@
 /**
- * The agent queue, as the framework reads it (#1774). The framework keeps no queue and imports no
+ * The agent queue, as OpenAgent reads it (#1774). OpenAgent keeps no queue and imports no
  * queue package: a project's queue comes from whichever of its packages declares that it provides
- * it — `"framework": { "queue": "<command>" }` in the package's own package.json — and the
- * framework reads it by running that command. Swap the package for another that answers the same
+ * it — `"openagent": { "queue": "<command>" }` in the package's own package.json — and
+ * OpenAgent reads it by running that command. Swap the package for another that answers the same
  * command line and prints the same shape, and nothing here changes. No package declares it: the
  * project has no queue, and the dashboard shows it none.
  *
  * The command line a provider answers, printing one JSON document and exiting 0:
  *   `<command> --local`   the open entries, in order of work, as an array of strings
- * `--local` reads the copy on this machine, no network: the framework polls.
+ * `--local` reads the copy on this machine, no network: OpenAgent polls.
  *
- * That is the whole contract. Writing the queue is not the framework's: a module the queue package
- * brings acts on it through its own command (`@openagt/dashboard/module`'s link actions), and the framework
+ * That is the whole contract. Writing the queue is not OpenAgent's: a module the queue package
+ * brings acts on it through its own command (`@openagt/dashboard/module`'s link actions), and OpenAgent
  * only re-reads.
  *
  * The shape, owned here: an entry is one string, the task a future agent is started with, as the
  * queue's own command prints it. A markdown link at its start names the work and where it points;
  * how a dashboard reads that is the queue package's module's.
  */
-/** A project's queue: what a provider answers, read by the framework. */
+/** A project's queue: what a provider answers, read by OpenAgent. */
 export interface QueueSource {
     /** The open entries, in order of work; `[]` when none can be read. */
     list(): Promise<string[]>;
@@ -32,14 +32,14 @@ export type QueueReader = QueueFor & {
 /** Entries read back from a provider's output: the non-empty strings of an array, trimmed; anything else is no entries. */
 export declare function parseQueueEntries(output: unknown): string[];
 /**
- * The production {@link QueueReader}: the project's provider, looked up by its package.json, one
+ * The production {@link QueueReader}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides — so the cache holds across the many
  * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
  * within {@link CACHE_MS}. `changed(root)` forgets that project's read, so the next read runs the
  * command again: a module's command just ran there, and may have written.
  */
 export declare function providedQueue(now?: () => number): QueueReader;
-/** The framework's one reader of the queue, shared by every caller so they share its cache. */
+/** OpenAgent's one reader of the queue, shared by every caller so they share its cache. */
 export declare const projectQueue: QueueReader;
 /** A {@link QueueFor} for a project with no provider: no queue. */
 export declare const noQueue: QueueFor;

package/dist/module-types/src/store/repository.d.ts

@@ -1,7 +1,7 @@
 /**
  * Creating a project's repository on a host, for a project that lives on this machine only. Like
- * every provided kind, the framework names no host: the package that declares
- * `"framework": { "repository": "<command>" }` creates it, and the framework asks by running that
+ * every provided kind, OpenAgent names no host: the package that declares
+ * `"openagent": { "repository": "<command>" }` creates it, and OpenAgent asks by running that
  * command.
  *
  * The command line a provider answers, each printing one JSON document and exiting 0 (a refusal

package/dist/module-types/src/store/run-record.d.ts

@@ -1,21 +1,21 @@
 import type { AnyDiaryLine, RunCard } from './runs.js';
-import type { FrameworkEvent } from '../events.js';
+import type { OpenAgentEvent } from '../events.js';
 import type { AgentMeta } from './agent-store.js';
 /**
- * A run's card and diary (`runs.ts`), read as the framework's own shapes (#1769): the card as the
+ * A run's card and diary (`runs.ts`), read as OpenAgent's own shapes (#1769): the card as the
  * meta every list shows, the diary as the events the run page replays and tails. The card's
  * eleven plain fields and four kinds of diary line are the shape; whoever ran the agent keeps the
- * rest of what it knows under one key, `caller`, and writes its other lines as they are. The
- * framework records no run of its own (#1774), so there is no writing half.
+ * rest of what it knows under one key, `caller`, and writes its other lines as they are.
+ * OpenAgent records no run of its own (#1774), so there is no writing half.
  */
-/** A card as the framework's meta: `caller` unfolded, the card's own fields winning. */
+/** A card as OpenAgent's meta: `caller` unfolded, the card's own fields winning. */
 export declare function fromRunCard(card: RunCard): AgentMeta;
 /**
- * One diary line as one framework event: what the agent said, its result, the run's end and its
- * cost are the shape's four kinds; a line of any other kind is a framework event as written, and
- * one whose kind is no longer an event (the kinds of runs recorded before The Framework stopped
+ * One diary line as one OpenAgent event: what the agent said, its result, the run's end and its
+ * cost are the shape's four kinds; a line of any other kind is an OpenAgent event as written, and
+ * one whose kind is no longer an event (the kinds of runs recorded before OpenAgent stopped
  * running agents) reads as nothing. The line's time, `at`, is the event's, whatever the kind.
  */
-export declare function fromDiaryLine(line: AnyDiaryLine): FrameworkEvent | undefined;
+export declare function fromDiaryLine(line: AnyDiaryLine): OpenAgentEvent | undefined;
 /** A diary as the run's events, for a reader that replays them. */
-export declare function eventsOf(lines: readonly AnyDiaryLine[]): FrameworkEvent[];
+export declare function eventsOf(lines: readonly AnyDiaryLine[]): OpenAgentEvent[];

package/dist/module-types/src/store/runs.d.ts

@@ -1,8 +1,8 @@
 /**
- * Finished runs, as the framework reads them (#1774). The framework keeps no run and imports no
+ * Finished runs, as OpenAgent reads them (#1774). OpenAgent keeps no run and imports no
  * records package: a project's finished runs come from whichever of its packages declares that it
- * provides them — `"framework": { "runs": "<command>" }` in the package's own package.json — and
- * the framework reads them by running that command. Swap the package for another that answers
+ * provides them — `"openagent": { "runs": "<command>" }` in the package's own package.json — and
+ * OpenAgent reads them by running that command. Swap the package for another that answers
  * the same command line and prints the same shapes, and nothing here changes. No package declares
  * it: the project has no finished runs, only the ones still running in a checkout.
  *
@@ -11,7 +11,7 @@
  *   `<command> show <id> --local --full`   one run: the whole card plus `diary`, every line
  *   `<command> delete <id>`                remove a run
  *   `<command> patch <id> [--branch <b>] [--pr <n> --pr-url <url>] [--landed <commit> --from <commit>]`   the late facts
- * `--local` reads the copy on this machine, no network: the framework polls.
+ * `--local` reads the copy on this machine, no network: OpenAgent polls.
  *
  * The shapes, owned here: {@link RunCard} and {@link AnyDiaryLine}. A running agent's own card in
  * its checkout is the same shape, written by the tool that runs it.
@@ -56,7 +56,7 @@ export interface FinishedRun {
     card: RunCard;
     diary: AnyDiaryLine[];
 }
-/** A project's finished runs: what a provider answers, read by the framework. */
+/** A project's finished runs: what a provider answers, read by OpenAgent. */
 export interface RunsSource {
     /**
      * Every finished run's card, newest first; `[]` when none can be read. `fresh` skips a list read
@@ -94,14 +94,14 @@ export declare function isRunId(id: string): boolean;
  */
 export declare function parseRunCard(input: unknown): RunCard | undefined;
 /**
- * The production {@link RunsFor}: the project's provider, looked up by its package.json, one
+ * The production {@link RunsFor}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides — so the cache holds across the many
  * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
  * within {@link CACHE_MS}. `changed(root)` forgets that project's reads, so the next read runs the
  * command again: a module's command just ran there, and may have written.
  */
 export declare function providedRuns(now?: () => number): RunsReader;
-/** The framework's one reader of finished runs, shared by every caller so they share its cache. */
+/** OpenAgent's one reader of finished runs, shared by every caller so they share its cache. */
 export declare const projectRuns: RunsReader;
 /** A {@link RunsFor} for a project with no provider: no finished runs. */
 export declare const noRuns: RunsFor;

package/dist/module-types/src/store/tickets.d.ts

@@ -1,16 +1,16 @@
 /**
- * The tickets, as the framework reads them (#1774). The framework keeps no ticket and imports no
+ * The tickets, as OpenAgent reads them (#1774). OpenAgent keeps no ticket and imports no
  * tickets package: a project's tickets come from whichever of its packages declares that it
- * provides them — `"framework": { "tickets": "<command>" }` in the package's own package.json —
- * and the framework reads them by running that command. Swap the package for another that answers
+ * provides them — `"openagent": { "tickets": "<command>" }` in the package's own package.json —
+ * and OpenAgent reads them by running that command. Swap the package for another that answers
  * the same command line and prints the same shape, and nothing here changes. No package declares
  * it: the project has no tickets, and the dashboard shows it none.
  *
  * The command line a provider answers, printing one JSON document and exiting 0:
  *   `<command> list --local`   every open ticket, as an array of {@link Ticket}
- * `--local` reads the copy on this machine, no network: the framework polls.
+ * `--local` reads the copy on this machine, no network: OpenAgent polls.
  *
- * That is the whole contract. The framework reads tickets for what it composes across skills: the
+ * That is the whole contract. OpenAgent reads tickets for what it composes across skills: the
  * onboarding step, a queued link's title. Showing them, planning them, claiming and releasing them,
  * and the Overview's hot-tickets card, are the tickets package's own module, through its own command.
  *
@@ -45,7 +45,7 @@ export interface Ticket {
     effort?: number;
     uncertainty?: number;
 }
-/** A project's tickets: what a provider answers, read by the framework. */
+/** A project's tickets: what a provider answers, read by OpenAgent. */
 export interface TicketsSource {
     /** Every open ticket; `[]` when none can be read. */
     list(): Promise<Ticket[]>;
@@ -59,14 +59,14 @@ export type TicketsReader = TicketsFor & {
 /** The rows read back from a provider's output: the objects with the five plain facts, everything else as printed; anything else is no ticket. */
 export declare function parseTickets(output: unknown): Ticket[];
 /**
- * The production {@link TicketsReader}: the project's provider, looked up by its package.json, one
+ * The production {@link TicketsReader}: the project's provider, looked up among the packages the project has (`built-in.ts`), one
  * source per project kept while the same command provides — so the cache holds across the many
  * reads of one poll, and a project that installs, swaps or drops its provider is read the new way
  * within {@link CACHE_MS}. `changed(root)` forgets that project's read, so the next read runs the
  * command again: a module's command just ran there, and may have written.
  */
 export declare function providedTickets(now?: () => number): TicketsReader;
-/** The framework's one reader of the tickets, shared by every caller so they share its cache. */
+/** OpenAgent's one reader of the tickets, shared by every caller so they share its cache. */
 export declare const projectTickets: TicketsReader;
 /** A {@link TicketsFor} for a project with no provider: no tickets. */
 export declare const noTickets: TicketsFor;

package/dist/module-types/src/terminal.d.ts

@@ -1,3 +1,3 @@
-import { type FrameworkEvent } from './events.js';
-/** Render a {@link FrameworkEvent} as one human-readable line (terminal surface). */
-export declare function formatFrameworkEvent(event: FrameworkEvent): string;
+import { type OpenAgentEvent } from './events.js';
+/** Render a {@link OpenAgentEvent} as one human-readable line (terminal surface). */
+export declare function formatOpenAgentEvent(event: OpenAgentEvent): string;

package/dist/open-choices.d.ts

@@ -1,4 +1,4 @@
-import type { ChoiceRequest, FrameworkEvent } from './events.js';
+import type { ChoiceRequest, OpenAgentEvent } from './events.js';
 /**
  * Every question a run still waits on, in the order asked, read off the run's events. One rule
  * for every surface that offers an answer (the run page, the open-questions list, the write
@@ -11,5 +11,5 @@ import type { ChoiceRequest, FrameworkEvent } from './events.js';
  * checkout kept, and the answer resumes it. A run that died holding a question ends otherwise,
  * and its question goes with it (#1359): nobody would read the pick.
  */
-export declare function pendingChoices(events: readonly FrameworkEvent[]): ChoiceRequest[];
+export declare function pendingChoices(events: readonly OpenAgentEvent[]): ChoiceRequest[];
 //# sourceMappingURL=open-choices.d.ts.map

package/dist/openagent-dir.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The directory, under a project root, that holds OpenAgent's own files.
+ *
+ * Its own module so every reader and writer of the directory (the hooks file, the project's saved
+ * prompts, a run's card, diary and inbox) spells it the same way. The name itself is
+ * `@openagt/agent-data`'s, which also makes the directory when a folder becomes a project.
+ */
+export { OPENAGENT_DIR } from '@openagt/agent-data/names';
+//# sourceMappingURL=openagent-dir.d.ts.map

package/dist/openagent-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openagent-dir.d.ts","sourceRoot":"","sources":["../src/openagent-dir.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/openagent-dir.js

@@ -0,0 +1,9 @@
+/**
+ * The directory, under a project root, that holds OpenAgent's own files.
+ *
+ * Its own module so every reader and writer of the directory (the hooks file, the project's saved
+ * prompts, a run's card, diary and inbox) spells it the same way. The name itself is
+ * `@openagt/agent-data`'s, which also makes the directory when a folder becomes a project.
+ */
+export { OPENAGENT_DIR } from '@openagt/agent-data/names';
+//# sourceMappingURL=openagent-dir.js.map

package/dist/openagent-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openagent-dir.js","sourceRoot":"","sources":["../src/openagent-dir.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/openagent-gitignore.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The `.openagent/.gitignore` (#313): one file, one content, written at install.
+ *
+ * Everything under `.openagent/` is this machine's or transient: a run's live files, the
+ * hooks file. The lasting records (the runs, the `logs` skill's) live on the data branch
+ * (#1582/#1769), so nothing is tracked, this file included: git shows no trace of the directory.
+ */
+/** The `.gitignore` path under `cwd`'s `.openagent/`. */
+export declare function gitignorePath(cwd: string): string;
+/** The whole file: everything under `.openagent/` stays out of git, the file itself too (#1582). */
+export declare function openagentGitignore(): string;
+//# sourceMappingURL=openagent-gitignore.d.ts.map

package/dist/openagent-gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openagent-gitignore.d.ts","sourceRoot":"","sources":["../src/openagent-gitignore.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/openagent-gitignore.js

@@ -0,0 +1,19 @@
+import { join } from 'node:path';
+import { DATA_BRANCH } from '@openagt/agent-data/names';
+import { OPENAGENT_DIR } from './openagent-dir.js';
+/**
+ * The `.openagent/.gitignore` (#313): one file, one content, written at install.
+ *
+ * Everything under `.openagent/` is this machine's or transient: a run's live files, the
+ * hooks file. The lasting records (the runs, the `logs` skill's) live on the data branch
+ * (#1582/#1769), so nothing is tracked, this file included: git shows no trace of the directory.
+ */
+/** The `.gitignore` path under `cwd`'s `.openagent/`. */
+export function gitignorePath(cwd) {
+    return join(cwd, OPENAGENT_DIR, '.gitignore');
+}
+/** The whole file: everything under `.openagent/` stays out of git, the file itself too (#1582). */
+export function openagentGitignore() {
+    return `# OpenAgent: agent state is transient; the lasting records live on the ${DATA_BRANCH} branch.\n*\n`;
+}
+//# sourceMappingURL=openagent-gitignore.js.map

package/dist/openagent-gitignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openagent-gitignore.js","sourceRoot":"","sources":["../src/openagent-gitignore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,CAAC,CAAA;AAC/C,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,kBAAkB;IAChC,OAAO,0EAA0E,WAAW,eAAe,CAAA;AAC7G,CAAC"}

package/dist/pick-directory.js

@@ -77,7 +77,7 @@ export async function pickDirectory(platform = process.platform, run = nodeDialo
         // A dialog needs a screen to appear on, and a daemon started over SSH or inside a container has
         // none — saying so beats spawning a helper that can only fail.
         if (!env.DISPLAY && !env.WAYLAND_DISPLAY)
-            return { ok: false, error: 'The machine running The Framework has no desktop session, so no folder dialog can open there.' };
+            return { ok: false, error: 'The machine running OpenAgent has no desktop session, so no folder dialog can open there.' };
         return openDialog(linuxDialogs(env.HOME ?? '.'), run);
     }
     return { ok: false, error: `The system folder picker is not available on ${platform}.` };
@@ -97,6 +97,6 @@ async function openDialog(dialogs, run) {
         return path ? { ok: true, path } : { ok: false, error: 'The folder dialog returned no path.' };
     }
     const names = dialogs.map(dialog => dialog.command).join(' or ');
-    return { ok: false, error: `The folder dialog needs ${names}, which the machine running The Framework does not have installed.` };
+    return { ok: false, error: `The folder dialog needs ${names}, which the machine running OpenAgent does not have installed.` };
 }
 //# sourceMappingURL=pick-directory.js.map

package/dist/pick-directory.js.map

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

package/dist/project-commands.d.ts

@@ -1,6 +1,6 @@
 /**
  * A project's commands (#1774): the skills written to be run by a person, read off the folders
- * the coding agents read them from. The framework ships no prompt text; what a project can be
+ * the coding agents read them from. OpenAgent ships no prompt text; what a project can be
  * asked to do is what its own command skills say. A skill that teaches the agent how to do
  * something (the tickets, the queue) is not a command: typed alone it starts an agent with
  * nothing to do, so the launcher does not list it.
@@ -13,6 +13,10 @@ export interface ProjectCommand {
     name: string;
     /** The `description` of the skill's front matter, when it has one. */
     description?: string;
+    /** The branch the skill has yet to reach, by name, when its text is in the folder but not on the branch agents start from: an agent started from that branch does not have the command. */
+    waiting?: string;
+    /** With `waiting`: whether the branch the folder is on has the skill, so an agent started from that branch does have the command. */
+    here?: true;
 }
 /**
  * The project's commands, by name: the skills whose front matter says

package/dist/project-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-commands.d.ts","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,yGAAyG;AACzG,eAAO,MAAM,WAAW,YAAI,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAExE,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAqBhF"}
+{"version":3,"file":"project-commands.d.ts","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,yGAAyG;AACzG,eAAO,MAAM,WAAW,YAAI,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAExE,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2LAA2L;IAC3L,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qIAAqI;IACrI,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAqBhF"}

package/dist/project-commands.js

@@ -3,7 +3,7 @@ import { join } from 'node:path';
 import { parse as parseYaml } from 'yaml';
 /**
  * A project's commands (#1774): the skills written to be run by a person, read off the folders
- * the coding agents read them from. The framework ships no prompt text; what a project can be
+ * the coding agents read them from. OpenAgent ships no prompt text; what a project can be
  * asked to do is what its own command skills say. A skill that teaches the agent how to do
  * something (the tickets, the queue) is not a command: typed alone it starts an agent with
  * nothing to do, so the launcher does not list it.

package/dist/project-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-commands.js","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AAEzC;;;;;;GAMG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAUxE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAClD,8FAA8F;IAC9F,uDAAuD;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAC9E,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACjG,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAQ;YAC/B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACpB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,KAAK,CAAC,0BAA0B,CAAC,KAAK,IAAI;gBAAE,SAAQ;YACxD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjI,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,qGAAqG;AACrG,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,SAAS,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QAC1C,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}
+{"version":3,"file":"project-commands.js","sourceRoot":"","sources":["../src/project-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAA;AAEzC;;;;;;GAMG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAU,CAAA;AAcxE;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAA;IAClD,8FAA8F;IAC9F,uDAAuD;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QACtF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAQ;YAC9E,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;YACjG,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAQ;YAC/B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YACpB,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;YAC9B,IAAI,KAAK,CAAC,0BAA0B,CAAC,KAAK,IAAI;gBAAE,SAAQ;YACxD,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;gBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,CAAC,OAAO,KAAK,CAAC,aAAa,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjI,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AAC5E,CAAC;AAED,qGAAqG;AACrG,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACrD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,IAAI,CAAC;QACH,MAAM,IAAI,GAAY,SAAS,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QAC1C,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAgC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC1G,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/project-errors.d.ts

@@ -7,13 +7,15 @@
  * line on the daemon's stdout and nothing else, which is the worst way to handle a state nobody
  * can see.
  *
- * A repository with no origin at all is not an error: a folder that was never shared is a normal
- * project. The sync records it as `localOnly`, a note the dashboard says quietly.
+ * A project whose data stays on this machine is not an error: a folder with no origin, or one the
+ * person does not share, is a normal project. The sync records why as `local`, a note the
+ * dashboard says quietly.
  *
  * In memory on purpose. Every emitter re-evaluates on its own cadence — the sync every minute —
  * so a restarted daemon re-learns each error within a tick, and there is no stale record to
  * outlive the condition that raised it.
  */
+import type { BranchReach } from '@openagt/agent-data';
 /**
  * What went wrong, by kind: the dashboard picks its wording from this, the message carries the
  * detail. `data-sync`: the data branch cannot converge with the remote. `provider`: which package
@@ -28,6 +30,8 @@ export interface ProjectError {
     /** ISO timestamp of when the error was first recorded; a re-report of the same code keeps it. */
     since: string;
 }
+/** Why a project's data stays on this machine: its repository has no origin, or the person keeps it here. */
+export type StaysLocal = Exclude<BranchReach, 'origin'>;
 /** The daemon's write side: one slot per (project, code). */
 export interface ProjectErrors {
     /**
@@ -40,15 +44,15 @@ export interface ProjectErrors {
     clear(projectPath: string, code: ProjectErrorCode): void;
     /** The project's current errors, oldest first. */
     list(projectPath: string): ProjectError[];
-    /** Whether the project's repository has no remote to sync with, as the last sync found it. */
-    setLocalOnly(projectPath: string, localOnly: boolean): void;
-    /** What the dashboard shows of the project: its errors, and whether it is local only. */
+    /** How far the project's data reaches, as the last sync found it. */
+    setReach(projectPath: string, reach: BranchReach): void;
+    /** What the dashboard shows of the project: its errors, and why its data stays local, if it does. */
     read(projectPath: string): ProjectState;
 }
-/** What the background jobs currently know of a project: what is wrong with it, and whether its repository has no remote. */
+/** What the background jobs currently know of a project: what is wrong with it, and why its data stays on this machine, if it does. */
 export interface ProjectState {
     errors: ProjectError[];
-    localOnly: boolean;
+    local?: StaysLocal;
 }
 /** The dashboard's read side, wired into its context. */
 export type ProjectErrorsReader = ProjectErrors['read'];

package/dist/project-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-errors.d.ts","sourceRoot":"","sources":["../src/project-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,CAAA;AAEvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAA;IACtB,sGAAsG;IACtG,OAAO,EAAE,MAAM,CAAA;IACf,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACvE,wEAAwE;IACxE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACxD,kDAAkD;IAClD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;IACzC,8FAA8F;IAC9F,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAAA;IAC3D,yFAAyF;IACzF,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAAA;CACxC;AAED,6HAA6H;AAC7H,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;AAEvD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,IAAuB,GAAG,aAAa,CA0BnF"}
+{"version":3,"file":"project-errors.d.ts","sourceRoot":"","sources":["../src/project-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,CAAA;AAEvD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAA;IACtB,sGAAsG;IACtG,OAAO,EAAE,MAAM,CAAA;IACf,iGAAiG;IACjG,KAAK,EAAE,MAAM,CAAA;CACd;AAED,6GAA6G;AAC7G,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAEvD,6DAA6D;AAC7D,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACvE,wEAAwE;IACxE,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACxD,kDAAkD;IAClD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAAA;IACzC,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACvD,qGAAqG;IACrG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,CAAA;CACxC;AAED,uIAAuI;AACvI,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAA;IACtB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAED,yDAAyD;AACzD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;AAEvD,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAM,IAAuB,GAAG,aAAa,CA2BnF"}