waterplane 0.0.1 → 0.1.11

package/node_modules/@waterplane/shared/dist/index.js

@@ -0,0 +1,334 @@
+/**
+ * waterplane wire protocol — shared between host daemon and web client.
+ *
+ * Transport: one WebSocket per browser tab. Messages are JSON, except
+ * raw PTY bytes which are framed as { t: "pty", ... } with base64 to keep
+ * everything on the single JSON channel (simplicity over micro-perf).
+ *
+ * This file is the INDEX, not the protocol. Every name below is re-exported, so
+ * `import { SessionInfo } from "@waterplane/shared"` keeps working and no call site
+ * anywhere needs to know which file a type moved to — which is the whole reason
+ * the split is safe to make. What it buys is that the protocol is now legible
+ * by subsystem, and that a feature touching one area stops rewriting the file
+ * every other feature also edits. It was 1,768 lines and 20 commits deep, which
+ * made it, with `App.tsx` and `main.ts`, one of the three permanent
+ * merge-conflict surfaces in the project.
+ *
+ * The DTOs are grouped by what a field is ABOUT; the two message unions are
+ * kept apart from them, because a union changes when a MESSAGE is added and a
+ * DTO changes when a FIELD is.
+ */
+/** A drivable session, and everything that describes one of them. */
+export * from "./wire/session.js";
+/** What a *Recently closed* row may say — clipped, optional, never guessed. */
+export * from "./closed.js";
+/** The follow-up flag: who set it, what it may say, its one wording. */
+export * from "./followup.js";
+/** What a conversation bookmark may say (R-conversations-007). */
+export * from "./bookmark.js";
+/** The emergency halt latch: its state, its receipt and the one refusal sentence. */
+export * from "./halt.js";
+/** The wire subset of a host-side backend descriptor — what a picker or a
+ *  capability check is allowed to know about a backend other than claude. */
+export * from "./wire/backend.js";
+/** The opt-in second opinion, and the audit of everything typed into a session. */
+export * from "./wire/sent.js";
+export * from "./plugin.js";
+export * from "./pluginfile.js";
+export * from "./pluginmaturity.js";
+export * from "./wire/updates.js";
+export * from "./stream.js";
+/** Metering, feature usage, scraped CLI usage, and the desktop's own load. */
+export * from "./wire/telemetry.js";
+/** Usage readings per source: claude's adapter, the chip's one cut, the long-press words. */
+export * from "./usagesources.js";
+/** What an arbitrary span cost, by hour, repo and conversation — `GET /api/costwindow`. */
+export * from "./wire/costwindow.js";
+/** Which notification kinds may fire at all — checked on BOTH ends. */
+export * from "./wire/notify.js";
+/** The Android background link: which frames a notify-only socket is sent. */
+export * from "./wire/notifylink.js";
+/** Work the host does on the user's behalf: backlog, builds, fan-out, downloads. */
+export * from "./wire/work.js";
+/** What got installed on which phone. One desktop, many devices — so the log of
+ *  what a build actually landed on lives with the desktop that produced it. */
+export * from "./wire/install.js";
+/** A picture of a running screen, and the claim the run is ALLOWED to make
+ *  about it — "verified" is reserved for an oracle reading, and everything that
+ *  was not measured is absent rather than zero. */
+export * from "./wire/capture.js";
+/** The exposure watch: rows, accepts and the setup-checklist rows built from them — the CLI and
+ *  the phone must agree on what is accepted. */
+export * from "./exposure.js";
+export * from "./exposurepush.js";
+/** A repo or worktree: its git state, its setup verdict, the CLI install behind it. */
+export * from "./wire/repo.js";
+/** Always-on context: what a conversation's first request carried, and a repo + desktop's every-turn rows. */
+export * from "./wire/alwayson.js";
+/** The reader view's document — the CLI's own conversation log, parsed. */
+export * from "./wire/transcript.js";
+/** The first-app onboarding job: plan, consent lines, persisted steps. */
+export * from "./wire/onboard.js";
+/** The two unions on the wire, `PROTOCOL_VERSION`, and the JSON codec. */
+export * from "./wire/messages.js";
+/** The shape check on a decoded client frame, ahead of the host's dispatch. */
+export * from "./clientframe.js";
+// A per-session budget (tokens, dollars, window percent): the verdict, the
+// calibration and the one predicate both ends hold a session's sends by.
+export * from "./sessionbudget.js";
+export * from "./spendwarn.js";
+// Send-queue scheduling (offline outbox): the one-send-per-session lane rule.
+export * from "./queue.js";
+// When a durable send was FIRST put on the wire — what lets a host that lost
+// its ack ledger fail closed on a pre-loss re-send.
+export * from "./sendstamp.js";
+// Where "the host" is when the app is NOT served by it — the Android shell
+// (packages/app) loads its UI out of the APK, so `/api` and `/ws` need aiming.
+export * from "./hosturl.js";
+// Several desktops on one phone: the saved-host list, its migration from the
+// one `hostBase`, the key parking a host switch does, and the per-host IDB.
+export * from "./hosts.js";
+// LAN or tailnet: the three ANDed gates and the sentence for each verdict,
+// plus the Android `ShellNet` plugin's `NetState` contract.
+export * from "./lanroute.js";
+// Pairing a new phone by QR: code format, deep link / landing URL, redeem DTOs.
+export * from "./pairing.js";
+// The paired-device ledger as the phone sees it.
+export * from "./devices.js";
+export * from "./passive.js";
+// Ask rules: the permission rules every claude launch is given as `permissions.ask`.
+export * from "./askrules.js";
+// Question identity — what makes an answer typed OFFLINE safe to deliver later.
+export * from "./promptid.js";
+// Which localStorage keys follow the USER rather than the browser, and why.
+export * from "./settings.js";
+// What colour a repo is: the ring the hue comes from, the hash that picks one,
+// and the answer a person may pin over it.
+export * from "./repocolor.js";
+// What every button MEANS, plus the one rule that decides when to say so.
+export * from "./hints.js";
+/** The HTTP fuse (see netfuse.ts) — here, not in `web`, so a node e2e can point
+ *  it at a server that never answers and prove the client gives up. */
+export * from "./netfuse.js";
+/** What the phone records when an HTTP request stalls (see netstall.ts). */
+export * from "./netstall.js";
+/** Scheduled prompts — a wall-clock rule, its zone, and the lead time before an
+ *  anchor (the weekly usage reset) that the rule is actually tracking. */
+export * from "./schedule.js";
+/** Reconstructed alt-screen scrollback — the only history a phone has when the
+ *  scroll it would otherwise send to the TUI can't reach it. */
+export * from "./screenlog.js";
+/** Gallery listings the phone can still answer with the tunnel down — what a
+ *  cached listing is allowed to be re-filtered into, and what it is not. */
+export * from "./gallery.js";
+/** Clearing OUT a transport directory: the age ladder, the cut, and the
+ *  sentences. Plans and describes — it deletes nothing and schedules nothing. */
+export * from "./sweep.js";
+/** The same clearing-out, cut by BUILD FAMILY rather than by age — the by-hand
+ *  half of `artifacts.ts`' automatic prune, over the same `familyKey`. */
+export * from "./sweepfamilies.js";
+/** What the DESKTOP is holding, as the phone reads it: the cross-repo
+ *  transport survey, and the daemon's own store by owner and by bound. */
+export * from "./deskstorage.js";
+/** What the LOCAL model runner is holding — the wire shapes, and the pure
+ *  "will a second model fit" sentence the phone says under the picker. */
+export * from "./wire/localrt.js";
+export * from "./wire/sysstat.js";
+export * from "./localrt.js";
+export * from "./wire/localusage.js";
+export * from "./localusage.js";
+/** A backend's own token ledger (`GET /api/tokenstats/<id>`) — never summed with claude's. */
+export * from "./wire/backendtokens.js";
+/** The seam a backend hands a fact over through, beside its screen reader. */
+export * from "./backendsources.js";
+/** One rule for what a 2.2 source slot may answer — the host's consumers and the plugin testkit both ask it. */
+export * from "./sourceshape.js";
+/** `caps.launchModes` (2.2): the modes a session can START in, one rule for host and phone. */
+export * from "./launchmodes.js";
+/** The conversation-binding ladder a backend plugin calls (plugin contract 2.0). */
+export * from "./bindconv.js";
+/** What became of the FILES a queued prompt names — the difference between a
+ *  prompt that is sendable as written and one that points at nothing. */
+export * from "./attach.js";
+/** A session the HOST is holding until the files its first prompt names have
+ *  landed — the handover that stops a bad tunnel from killing a whole plan. */
+export * from "./launch.js";
+/** The one wording of the host retrying a turn the CLI gave up on a transient
+ *  API error (`SessionNetRetry`). */
+export * from "./netretry.js";
+export * from "./netretrycfg.js";
+/** Several pictures as ONE picture — the arrangement, so a mark can span the
+ *  screens it is about. Pure geometry; the canvas half lives in web. */
+export * from "./collage.js";
+/** The pad's per-note merge and its tombstones — what stops a synced pad from
+ *  deleting notes behind your back — plus the words the sheet says. */
+export * from "./pad.js";
+/** The usage BUDGET — the ceiling that stops automatic work BEFORE the CLI's
+ *  own limit banner, and lets it start again when the window resets. */
+export * from "./budget.js";
+/** Budget PERIODS (rolling, calendar month/week/day, span), the one `periodBounds`
+ *  that decides their edges, and the pacing maths over a period's spend. */
+export * from "./period.js";
+/** The billing profile (subscription / api / cloud / unknown) and the pure
+ *  classifier the host's probe feeds. */
+export * from "./billing.js";
+/** The health of every point where this app reads a CLI it does not own — the
+ *  rule that makes degrading to null stop being quiet. */
+export * from "./clihealth.js";
+/** How big a model's context window is — the one number that makes every
+ *  session's context graph share a y axis instead of each inventing its own. */
+export * from "./ctxwindow.js";
+/** How much of a small model's window Claude Code's own prompt takes — the
+ *  picker's sentence, from two measured numbers or none. */
+export * from "./windowadvice.js";
+/** What one more turn in a session costs against a fresh one — the reminder
+ *  behind the cost chip, the context sheet's top panel and the one toast. Pure,
+ *  and deliberately produces sentences and never a refusal. */
+export * from "./sessioncost.js";
+/** What a repo costs to have open before anyone types — CLAUDE.md plus the
+ *  skill descriptions, which are the always-loaded half. Behind the repo-setup
+ *  checklist's context-weight row. */
+export * from "./contextweight.js";
+/** Every agent-instruction file in a folder, who reads it (Claude Code, Copilot) and when; the repeats between them. */
+export * from "./agentfiles.js";
+/** What this desktop adds to every session, whatever the repo; and the always-on rows and sentences both ends word alike. */
+export * from "./desktopfiles.js";
+export * from "./alwaysonwords.js";
+/** Which `autoCompactWindow` a spawned session would see, and from where —
+ *  env > repo local > repo > user. Behind the checklist's auto-compact row. */
+export * from "./autocompact.js";
+/** Opt-ins: the advanced things a repo can turn on — one catalog, a probe per
+ *  offer on the host, three states the person controls, counted in nothing. */
+export * from "./optins.js";
+/** What a pile of token counts MEANS — the derived figures and the words for
+ *  them, including why a single "tokens used" number is 96% cache reads. */
+export * from "./tokens.js";
+/** What those tokens WOULD have cost at Anthropic's published list prices — a
+ *  counterfactual, not a bill, and the module says so at length. */
+export * from "./pricing.js";
+/** The durable Intent — one "do this, there, when that is true", owned by the
+ *  HOST, and the one ladder that decides whether it may run yet. */
+export * from "./intent.js";
+export * from "./fanoutruns.js";
+/** The cost window read both ways: the hour bucket, launches, ranked repos,
+ *  dollars-per-weekly-point (a refusal when it cannot be calibrated), and the
+ *  burn rate's reset-cut stretch and push words. */
+export * from "./costwindow.js";
+/** A backend's own ledger cut to a span, on its hours — beside claude's figure, never in it (c2). */
+export * from "./ledgerspan.js";
+export * from "./burn.js";
+/** "Of the work still standing, what is actually still worth doing?" — the
+ *  rules that stop a confident-sounding assessment from retiring real work. */
+export * from "./assess.js";
+/** What a machine may CALL somebody else's words — the four kinds, the author
+ *  stamp that says whether a title may be overwritten, and the one display rule
+ *  deciding whose name is on a row. */
+export * from "./naming.js";
+/** The change brief: the focus list both ends word alike, and its answer's shape. */
+export * from "./changebrief.js";
+/** The files an item's words name — images anywhere and the inbox/outbox
+ *  transport by full path (the row's thumbnails; anything folding two items
+ *  into one must keep every one). */
+export * from "./itempaths.js";
+// A URL the terminal GRID broke across rows, put back together — what makes a
+// `/login` link on a phone something you can tap instead of transcribe.
+export * from "./urls.js";
+export * from "./slash.js";
+/** The slash sheet's answer (`GET /api/slash`), a backend's own list included (2.2 `commands`). */
+export * from "./wire/slash.js";
+/** What a repo can already build, read out of its own manifests — the free half
+ *  of the Build sheet's "set up", for adding one more command without spending
+ *  a turn on it. */
+export * from "./buildscan.js";
+/** Cleaning, merging and wording the install log — the half that must not lose
+ *  or duplicate a history when a phone re-reports everything on every connect. */
+export * from "./installlog.js";
+/** What a build leaves behind and what it is called: the collect-into-the-outbox
+ *  policy, the versioned name, `familyKey` ("which artifact IS this"), the fold
+ *  that stops one APK arriving twice, and what a prune may remove. */
+export * from "./artifacts.js";
+/** Which build is this: the version + commit + time stamped into an artifact, and the
+ *  per-repo `versions.jsonl` record the build list reads — one wording for both. */
+export * from "./buildstamp.js";
+/** What a build button ASKS before it runs — one command against one member of
+ *  a monorepo, instead of forty near-identical buttons. Substitution, the env
+ *  copy, and the refusal that stops an unattended run guessing a value. */
+export * from "./buildparams.js";
+/** The geometry a PTY may be given, and the floor under it — a grid too small
+ *  for the CLI to draw its composer in is a grid no delivery can be confirmed
+ *  against, so neither end accepts one. */
+export * from "./ptysize.js";
+/** The CLI's own working line, read off raw PTY bytes — what the agent is doing
+ *  right now. One matcher for the phone's reader and the host's turn-end
+ *  verification, because they are one question. */
+export * from "./working.js";
+/** The keys the CLI's footer and pickers tell a person to press, and the
+ *  bytes each one is — the host reads the hints, the phone offers the keys. */
+export * from "./keyhint.js";
+/** A key with Ctrl / Alt / Shift held, as xterm's bytes — the phone's sticky
+ *  modifiers and its Keys sheet send through this one encoding. */
+export * from "./chord.js";
+/** Dictation's wire shape: the audio format the phone writes and the host
+ *  reads, the caps in seconds, and the one wording for a clip that is refused
+ *  — so a person is told the same thing whichever end noticed. */
+export * from "./dictate.js";
+export * from "./dictateterms.js";
+/** The zero-token repo-health series: where the tool and its artifacts live,
+ *  the shapes a status and a plot arrive as, and the sentence for every state
+ *  that has nothing to draw. */
+export * from "./repohealth.js";
+/** The other half of the same subject: the parsers that stop the host and the
+ *  phone reading one line of the engine's output two different ways. Split out
+ *  because a dropped field and a wrong sentence fail differently — and because
+ *  the one file was at the lint cap. */
+export * from "./repohealthread.js";
+/** The health index: the one layer over the repo-health series that takes a
+ *  side (an absolute 0–100 score per week), with its move test and wording. */
+export * from "./healthindex.js";
+/** The whole index answer from a series file, for the host route and the VS Code view alike. */
+export * from "./healthindexresponse.js";
+/** The context one request carried, per week, for the line beside the score. */
+export * from "./healthspend.js";
+/** A repo's requirements list: the prompt filter, the item format, the preset. */
+export * from "./requirements.js";
+/** Where the claude CLI keeps its private dir (CLAUDE_CONFIG_DIR) and its project-folder slug rule. */
+export * from "./claudeconfig.js";
+export * from "./statedir.js";
+/** A live session running an older `claude` than the installed one, and the
+ *  words for restarting it onto the new binary in the SAME conversation. */
+export * from "./clirestart.js";
+/** What a background shell under a session is DOING, in words: the bucket a
+ *  reading falls into, the sentence for it, the chip and the close-confirm
+ *  line — pure, over the raw facts `host/shells.ts` reads off the process
+ *  table. */
+export * from "./shells.js";
+/** Which product this is — every brand-bearing identifier, current and past —
+ *  and the pure readers that fall back through the past ones. */
+export * from "./brand.js";
+export * from "./envresolve.js";
+export * from "./brandmigrate.js";
+/** Peer desktops: delegate a job to another host and take its report back —
+ *  the wire DTOs, the address and remote-identity rules, the report prompt. */
+export * from "./peer.js";
+export * from "./claudeversion.js";
+/** The oldest Node the host runs on (engines, doctor, the early refusal). */
+export * from "./nodemin.js";
+/** The terminal background/foreground per theme: the phone grid and the
+ *  host answer to the tmux client colour queries. */
+export * from "./termpalette.js";
+/** The caps and pure folds every conversation reader shares (claude's jsonl and a plugin's store reader). */
+export * from "./transcriptfold.js";
+/** A fork's `<config dir>/theme.json`: colour tokens, terminal palette, display name. */
+export * from "./themeoverlay.js";
+/** The code folder: `GET/POST /api/host/root` and whether the first-start dialog asks. */
+export * from "./rootchoice.js";
+/** The week-end burn: when to start spending the rest of a week, when to stop,
+ *  the once-a-week nudge, and the words — one reading for host and phone. */
+export * from "./weekburn.js";
+/** What the remote's own rules demand of a push to the default branch
+ *  (direct / pr / pr-checks): a pure classifier, absent when unreadable. */
+export * from "./branchmode.js";
+/** The PR card: the DTO and the one place a PR's blocker is worded. */
+export * from "./wire/pullrequest.js";
+export * from "./prview.js";
+//# sourceMappingURL=index.js.map

package/node_modules/@waterplane/shared/dist/index.js.map

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

package/node_modules/@waterplane/shared/dist/installlog.d.ts

@@ -0,0 +1,137 @@
+/**
+ * **The install log's rules** — cleaning a report, merging it into the store,
+ * and the sentences both ends say about it.
+ *
+ * Pure, so the host's store and the phone's screen cannot disagree about what
+ * an entry means, and so the merge — the one part that can silently lose or
+ * duplicate a person's history — is pinned by `node --test` with no daemon.
+ *
+ * Everything here is written against ONE assumption: **a report is a
+ * re-statement of what a phone still holds, not a stream of events.** A phone
+ * re-sends its whole install history on every connect, because the install it
+ * most needs to report is the one that happened while the tunnel was down. So
+ * merging is keyed and idempotent, and a hundred reconnects add nothing.
+ */
+import type { InstallDevice, InstallLogDoc, InstallLogEntry, InstallOutcome, InstallReportEntry, InstallReporter } from "./wire/install.js";
+export type { InstallDevice, InstallLogDoc, InstallLogEntry, InstallOutcome, InstallReportEntry, InstallReporter };
+/** How many installs the host keeps. Two phones updating four apps a day reach
+ *  this in about two months, which is longer than anybody asks "when did this
+ *  land" about. Oldest goes first. */
+export declare const INSTALL_LOG_CAP = 500;
+/** Entries one report may carry. A phone holds at most a couple of hundred
+ *  download rows; past this something is wrong and the store is not the place
+ *  to find out. */
+export declare const MAX_REPORT_ENTRIES = 300;
+/** The identity of one install. The `at` is in it on purpose: installing the
+ *  same build twice is two things that happened, and a key that folded them
+ *  together would lose the second. A shell that cannot say when falls to `0`,
+ *  which folds its re-installs into one row — the honest consequence of not
+ *  knowing, rather than a row per reconnect. */
+export declare function installKey(deviceId: string, pullId: string, at?: number): string;
+/**
+ * One reported entry, cleaned — or null where it is not an install.
+ *
+ * A row is dropped, never repaired, when it has no package or no recognisable
+ * outcome: an entry that cannot say WHAT was installed is not a log line, it is
+ * a gap pretending to be one.
+ */
+export declare function cleanInstallEntry(raw: unknown, reporter: InstallReporter, reportedAt: number): InstallLogEntry | null;
+/** The slice of a phone's download row a report is built from. Named here
+ *  rather than taken as `PullRecord` so the fold below is pure and testable
+ *  with no browser — and so the two judgements in it are pinned rather than
+ *  buried in a module that imports IndexedDB. */
+export interface InstallReportRow {
+    id: string;
+    /** The file it arrived as. */
+    name?: string;
+    repo?: string;
+    pkg?: string;
+    label?: string;
+    version?: string;
+    code?: number;
+    install?: string;
+    installError?: string;
+    installedAt?: number;
+    /** Absent where the shell never recorded it — carried through as absent, not
+     *  flattened to `false` (`wire/install.ts` says why). */
+    installAuto?: boolean;
+}
+/**
+ * Every install a phone still has a record of, as report entries.
+ *
+ * Two judgements, both of which are the point:
+ *
+ *  - **Only a TERMINAL outcome is reported.** `asked` is the system installer
+ *    waiting for a person — it may wait for hours and may never be answered —
+ *    and a log that recorded it would be claiming an install that has not
+ *    happened. `installing` is the same claim in the present tense.
+ *  - **A row with no package is dropped.** The log's whole subject is WHICH app,
+ *    and three repos on this desktop build a file called `app-debug.apk`.
+ */
+export declare function installReportFrom(rows: readonly InstallReportRow[]): InstallReportEntry[];
+/** When an entry HAPPENED, for sorting and for the device's own clock. The
+ *  install's instant where the phone could say, else the moment it was
+ *  reported — and every sentence that prints this says which it is. */
+export declare function entryAt(e: InstallLogEntry): number;
+/**
+ * Fold a report into the store.
+ *
+ * **Re-reporting is not re-recording.** An entry already held keeps its
+ * original `reportedAt` — that is the moment the host first heard about it, and
+ * rewriting it on every reconnect would make a week-old install look like it
+ * happened at the last handshake. What a repeat MAY do is fill in facts that
+ * were absent the first time (the phone learnt the app's label, or got a name
+ * of its own), because absent is not a claim and an improvement is not a
+ * conflict.
+ *
+ * Returns the new list plus what actually changed, so a caller can decide
+ * whether anything is worth persisting or broadcasting.
+ */
+export declare function mergeInstallLog(existing: readonly InstallLogEntry[], incoming: readonly InstallLogEntry[], cap?: number): {
+    entries: InstallLogEntry[];
+    added: number;
+    updated: number;
+};
+/**
+ * The devices, derived from the entries.
+ *
+ * Derived rather than stored for one reason: a device list kept beside the log
+ * can disagree with it — a phone whose entries all aged out would linger as a
+ * row claiming installs nobody can see. The newest entry's name wins, because a
+ * rename should show up as the name that phone has NOW.
+ */
+export declare function installDevices(entries: readonly InstallLogEntry[]): InstallDevice[];
+/** What to call a device on screen: the name somebody gave it, then the model
+ *  the browser admitted to, then the id — which says nothing, so it is last and
+ *  is shortened, because twelve hex characters is not a name. */
+export declare function deviceLabel(d: {
+    id: string;
+    name?: string;
+    model?: string;
+}): string;
+/** The same question about an ENTRY, whose device fields are a snapshot of what
+ *  that phone called itself at the time. */
+export declare function entryDeviceLabel(e: InstallLogEntry): string;
+/** What was installed, as one name: the app's own label with the version it
+ *  landed at. The package is NOT in it — three repos here build `app-debug.apk`
+ *  and the package is what tells them apart, so it is its own line on screen
+ *  rather than glued into this one. */
+export declare function installTitle(e: InstallLogEntry): string;
+/**
+ * The sentence for one entry.
+ *
+ * Says WHEN honestly: an install the phone timed is said as a time, and one it
+ * could not is said as *reported*, which is a claim about the log rather than
+ * about the install. Says WHO by name. Says whether anybody tapped.
+ */
+export declare function installLogLine(e: InstallLogEntry, fmt: (ms: number) => string): string;
+/** The one line above the log. Counts devices as well as installs, because the
+ *  whole reason this exists is that there is more than one phone. */
+export declare function installLogSummary(doc: InstallLogDoc): string;
+/** The log cut to one device, or to one package. A count on a control is a
+ *  filter (`CLAUDE.md`), so the screen that prints "3 on this phone" has to be
+ *  able to open exactly those three. */
+export declare function filterInstallLog(entries: readonly InstallLogEntry[], filter: {
+    deviceId?: string;
+    pkg?: string;
+}): InstallLogEntry[];