appduct 0.15.1 → 0.16.0

package/dist/client/app-client.d.ts

@@ -8,7 +8,7 @@
  * (`mcp/events-tool.ts`) uses — called on a fresh stream opened for that one wait, so concurrent
  * waits on the same `AppClient` never share (and can't clobber) one connection's subscription.
  */
-import { type AppEvent, type FullAppEvent, type ListedToolDescriptor } from "@appduct/shared";
+import { type AppEvent, type FullAppEvent, type ListedToolDescriptor, type SessionState } from "@appduct/shared";
 import type { DaemonStream } from "../rpc/client.js";
 /** A project's own tool map — declared once, e.g. `type Tools = { sum: { args: { a: number; b:
  * number }; result: { total: number } } }` — to get typed {@link AppClient.call} throughout a test
@@ -93,6 +93,13 @@ export type EventsResult = EventsCounts & {
 export type { AppEvent, FullAppEvent } from "@appduct/shared";
 export type AppClient<TTools = ToolMap> = {
     readonly sessionId: string;
+    /** The session's state now: `active` while the app is connected, `suspended` while it is away
+     * (its process died, it was backgrounded or a page closed) and may still come back. Rejects with
+     * `"unknown_session"` once the session is gone. */
+    state(): Promise<SessionState>;
+    /** Ends the session: the daemon disconnects the app and forgets the session, so it can never
+     * resume. Works in any state. */
+    revoke(): Promise<void>;
     /** `tools.list` for this session. An entry spells an ungrouped tool's `group` as `null`,
      * where a registration omits it. */
     tools(): Promise<ListedToolDescriptor[]>;

package/dist/client/index.d.ts

@@ -17,4 +17,4 @@ export { link, waitForSession, type LinkOptions, type LinkResult, type WaitForSe
 export { AppductError, type AppductErrorType } from "./errors.js";
 export type { AppClient, AppEvent, CallOptions, EventsOptions, EventsResult, FullAppEvent, FullEventsResult, ToolMap, WaitForEventOptions, } from "./app-client.js";
 export type { TruncatedAppEvent } from "@appduct/shared";
-export type { AgentEndpoint, ErrorType, ListedToolDescriptor, ToolDescriptor } from "@appduct/shared";
+export type { AgentEndpoint, ErrorType, ListedToolDescriptor, SessionState, ToolDescriptor } from "@appduct/shared";

package/dist/client/index.js

@@ -1332,6 +1332,20 @@ var makeAppClient = (stream, sessionId, openStream) => {
   const openWaitStreams = /* @__PURE__ */ new Set();
   const client = {
     sessionId,
+    state: async () => {
+      try {
+        return (await stream.call(RPC_METHODS3.sessionsDescribe, { selector: sessionId })).state;
+      } catch (error) {
+        throw toAppductError(error);
+      }
+    },
+    revoke: async () => {
+      try {
+        await stream.call(RPC_METHODS3.sessionsRevoke, { selector: sessionId });
+      } catch (error) {
+        throw toAppductError(error);
+      }
+    },
     tools: async () => {
       try {
         const result = await stream.call(RPC_METHODS3.toolsList, {
@@ -2540,14 +2554,6 @@ var waitForSession = async (sessionId, options = {}) => {
   }
   const openStream = () => openDaemonStream({ stateDir, spawn: options.spawn, autoSpawn: options.autoSpawn });
   try {
-    try {
-      await stream.call(RPC_METHODS6.sessionsDescribe, { selector: sessionId });
-      return makeAppClient(stream, sessionId, openStream);
-    } catch (error) {
-      if (!(error instanceof DaemonRpcError) || error.data?.type !== "unknown_session") {
-        throw error;
-      }
-    }
     await new Promise((resolve2, reject) => {
       let settled = false;
       const settle = (fn) => {
@@ -2589,9 +2595,16 @@ var waitForSession = async (sessionId, options = {}) => {
           settle(resolve2);
         }
       });
-      stream.call(RPC_METHODS6.eventsSubscribe, { sessionSelector: sessionId, kinds: ["session_claimed"] }).catch((error) => {
-        settle(() => reject(toAppductError(error)));
-      });
+      const fail = (error) => settle(() => reject(toAppductError(error)));
+      stream.call(RPC_METHODS6.eventsSubscribe, { sessionSelector: sessionId, kinds: ["session_claimed"] }).then(() => {
+        stream.call(RPC_METHODS6.sessionsDescribe, { selector: sessionId }).then(
+          () => settle(resolve2),
+          // Not claimed yet: the subscription reports the claim when it comes.
+          (error) => {
+            if (!(error instanceof DaemonRpcError) || error.data?.type !== "unknown_session") fail(error);
+          }
+        );
+      }, fail);
     });
     return makeAppClient(stream, sessionId, openStream);
   } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appduct",
-  "version": "0.15.1",
+  "version": "0.16.0",
   "description": "Call functions inside your running iOS, Android or React Native app from a terminal, test or AI agent.",
   "type": "module",
   "main": "./dist/index.js",
@@ -47,7 +47,7 @@
     "reflect-metadata": "^0.2.2",
     "toqr": "^0.1.1",
     "ws": "^8.18.3",
-    "@appduct/shared": "0.15.1"
+    "@appduct/shared": "0.16.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
@@ -61,8 +61,8 @@
     "typescript": "~5.9.2",
     "vite": "^8.1.4",
     "webpack": "^5.111.1",
-    "@appduct/web": "0.15.1",
-    "@appduct/react-native": "0.15.1"
+    "@appduct/web": "0.16.0",
+    "@appduct/react-native": "0.16.0"
   },
   "files": [
     "bin.js",