appduct 0.12.0 → 0.14.0

package/dist/output.d.ts

@@ -8,18 +8,41 @@ export type RenderOptions = {
      * (which is only attached under `--verbose`). Defaults to the wall clock when omitted, matching
      * the pre-`--verbose` fallback behavior for a caller that doesn't care (e.g. non-`ls` tests). */
     now?: Date;
-    /** `link`-only: also render the deep link as terminal QR art (never affects `--json` output). */
+    /** `sessions link`-only: also render the deep link as terminal QR art (never affects `--json`
+     * output). */
     qr?: boolean;
-    /** `tools`-only: render full schemas/annotations for every listed tool, not just name+description. */
+    /** `tools ls`-only: render full schemas/annotations for every listed tool, not just
+     * name+description. */
     full?: boolean;
 };
 export declare const renderResult: (result: CliResult<unknown>, options: RenderOptions) => {
     stdout?: string;
     stderr?: string;
 };
-/** Renders one `appduct events` line: NDJSON under `--json`, a compact human line otherwise. */
+/** Renders one `appduct events tail`/`appduct events since` line: NDJSON under `--json`, a
+ * compact human line otherwise. */
 export declare const renderEventLine: (event: EventNotification, flags: GlobalFlags) => string;
-/** Renders the trailing cursor line for `appduct events --since` (issue #6): NDJSON under
+/** The filter flags to echo back into the hinted resume command in {@link renderEventsCursorLine}
+ * (issue #115's should-fix on #96's echoed selector): the same `--name`/`--payload-max-bytes`
+ * the caller passed to this pull, forwarded as-is so following the hint doesn't silently widen
+ * the query. */
+export type EventsCursorLineFilters = {
+    name?: string;
+    payloadMaxBytes?: number;
+};
+/** Renders the trailing cursor line for `appduct events since` (issue #6): NDJSON under
  * `--json` so a scripted caller can parse the resume point without maxing `seq` over the printed
- * events (impossible when the response is empty), a human note otherwise. */
-export declare const renderEventsCursorLine: (cursor: number, flags: GlobalFlags) => string;
+ * events (impossible when the response is empty), a human note otherwise. `selector` is the
+ * device/session selector the caller passed (issue #96): with two devices connected, a resume
+ * hint that dropped it would resolve to `ambiguous_session`, so it is echoed back in the hinted
+ * command when present. `dropped`/`remaining` (issue #115) are carried straight from
+ * `events.since`'s own result: how many events fell off the retention buffer before this pull,
+ * and how many matching events are still waiting beyond this page. `filters` (issue #115) are the
+ * `--name`/`--payload-max-bytes` flags this pull used: without them the hint would silently drop
+ * the query's filter and cap, so they are echoed into the hinted command exactly like the
+ * selector (`--name`'s glob is shell-quoted since it can carry `*` or spaces). */
+export declare const renderEventsCursorLine: (cursor: {
+    cursor: number;
+    dropped: number;
+    remaining: number;
+}, flags: GlobalFlags, selector?: string, filters?: EventsCursorLineFilters) => string;

package/dist/rpc/client.d.ts

@@ -123,7 +123,7 @@ export type DaemonStream = {
     /** Subscribes to server→client `"event"` notifications; returns an unsubscribe function. */
     onNotification: (callback: (payload: unknown) => void) => () => void;
     /** Fires once when the underlying socket closes (daemon gone, stop(), etc.); returns an
-     * unsubscribe function. Lets long-lived stream consumers (e.g. `appduct events`) end
+     * unsubscribe function. Lets long-lived stream consumers (e.g. `appduct events tail`) end
      * gracefully instead of hanging once the connection is no longer usable. */
     onClose: (callback: () => void) => () => void;
     close: () => void;

package/dist/scheme.d.ts

@@ -1,7 +1,7 @@
 /**
  * Deep-link scheme resolution (ARCHITECTURE.md §10, issue #29).
  *
- * A scheme is needed to compose `<scheme>:///?appduct=<payload>` in `appduct link`,
+ * A scheme is needed to compose `<scheme>:///?appduct=<payload>` in `appduct sessions link`,
  * `appduct/client`'s `link()` and the MCP `appduct_connect` tool. Before this module the only
  * source was `<state-dir>/config.json` — a single global file, which meant two apps with different
  * schemes on one machine required hand-editing it on every switch.
@@ -126,7 +126,7 @@ export declare const globalConfigDirs: (options?: ProjectConfigLookupOptions) =>
  * documented precedence:
  *
  * - `<homeDir>/.appduct`, the default state dir. Essentially every project lives somewhere under
- *   the home directory, so without this a plain `appduct link` in any repo would pick up the
+ *   the home directory, so without this a plain `appduct sessions link` in any repo would pick up the
  *   global `config.json` as if it were the project's — and with `--state-dir` pointing elsewhere it
  *   would shadow the state dir the operator explicitly chose.
  * - `stateDirRoot`, the state dir actually in use, for the same reason when it is not the default.
@@ -191,7 +191,7 @@ export type ResolveSchemeOptions = {
 export declare const resolveScheme: (options?: ResolveSchemeOptions) => Promise<ResolvedScheme>;
 /**
  * The shared "no scheme anywhere" message. Every caller renders the same body so the locations
- * listed (and the fixes suggested) can't drift between `appduct link`, `appduct mcp` and
+ * listed (and the fixes suggested) can't drift between `appduct sessions link`, `appduct mcp` and
  * `appduct_connect`.
  */
 export declare const describeMissingScheme: (tried: string[]) => string;
@@ -210,7 +210,7 @@ export type ResolveAppIdOptions = {
     /** Which `appId.<platform>` key to read from a project config; see `cli/open-target.ts`'s
      * `platformOf`. */
     platform: AppIdPlatform;
-    /** `--app-id` (CLI `link`) / `appId` (MCP `appduct_connect`) / `appId` (`mintLink`, the
+    /** `--app-id` (CLI `sessions link`) / `appId` (MCP `appduct_connect`) / `appId` (`mintLink`, the
      * `appduct/client` `link()`) — highest precedence, because the target is known at the call
      * site. */
     flagAppId?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appduct",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Driving React Native tools without in-app debug UI.",
   "type": "module",
   "main": "./dist/index.js",
@@ -45,7 +45,7 @@
     "reflect-metadata": "^0.2.2",
     "toqr": "^0.1.1",
     "ws": "^8.18.3",
-    "@appduct/shared": "0.12.0"
+    "@appduct/shared": "0.14.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",

package/dist/cli/routes/events.d.ts

@@ -1,3 +0,0 @@
-/** Route for `appduct events` — loaded by `cli/dispatch.ts`'s router only when it runs. */
-import type { Route } from "../router.js";
-export declare const route: Route;

package/dist/cli/routes/invoke.d.ts

@@ -1,3 +0,0 @@
-/** Route for `appduct invoke` — loaded by `cli/dispatch.ts`'s router only when it runs. */
-import type { Route } from "../router.js";
-export declare const route: Route;

package/dist/cli/routes/link.d.ts

@@ -1,3 +0,0 @@
-/** Route for `appduct link` — loaded by `cli/dispatch.ts`'s router only when it runs. */
-import type { Route } from "../router.js";
-export declare const route: Route;

package/dist/cli/routes/ls.d.ts

@@ -1,3 +0,0 @@
-/** Route for `appduct ls` — loaded by `cli/dispatch.ts`'s router only when it runs. */
-import type { Route } from "../router.js";
-export declare const route: Route;

package/dist/cli/routes/revoke.d.ts

@@ -1,3 +0,0 @@
-/** Route for `appduct revoke` — loaded by `cli/dispatch.ts`'s router only when it runs. */
-import type { Route } from "../router.js";
-export declare const route: Route;

package/dist/cli/routes/tools.d.ts

@@ -1,3 +0,0 @@
-/** Route for `appduct tools` — loaded by `cli/dispatch.ts`'s router only when it runs. */
-import type { Route } from "../router.js";
-export declare const route: Route;