@kaoruisaac/pedelec 0.1.5 → 0.1.6

package/README.md

@@ -150,6 +150,15 @@ const status = await pedelec.getApprovalStatus();
 console.log(status.installed, status.approved, status.origin);
 ```
 
+For a complete Extension, approval, and Desktop readiness probe, use `checkAvailability()`. It never creates/resumes a session or opens approval. When approved it validates Desktop by calling `getSettings()`, which may invoke the existing Native Host auto-launch fallback.
+
+```ts
+const availability = await pedelec.checkAvailability();
+if (availability.available) startUi();
+```
+
+An unavailable extension may be disconnected rather than absent. `desktop.launchAttempted` means the settings probe was sent, not that Desktop was confirmed to have launched. Invalid settings responses also count as Desktop unavailable in this probe.
+
 ### Specifying Provider and Model
 
 ```ts

package/dist/index.d.ts

@@ -110,6 +110,21 @@ export type ApprovalStatus = {
     approved: boolean;
     origin: string | null;
 };
+export type PedelecAvailability = {
+    available: boolean;
+    extension: {
+        available: boolean;
+    };
+    approval: {
+        approved: boolean;
+        origin: string | null;
+    };
+    desktop: {
+        available: boolean;
+        launchAttempted: boolean;
+    };
+    error?: PedelecError;
+};
 export type PedelecError = {
     code: string;
     message: string;
@@ -220,6 +235,7 @@ export declare class Pedelec {
     request<T>(type: string, payload?: Record<string, unknown>): Promise<T>;
     unregisterSession(sessionId: string): void;
     private resolveCreateSessionInput;
+    checkAvailability(): Promise<PedelecAvailability>;
     private resolveDefaultCreateSessionInput;
     private resolveProviderOnlyCreateSessionInput;
     private assertDefaultProviderAvailable;

package/dist/index.js

@@ -264,6 +264,58 @@ export class Pedelec {
             autoEndOnDisconnect,
         };
     }
+    async checkAvailability() {
+        const origin = getCurrentOrigin(this.pageWindow);
+        let approval;
+        try {
+            approval = await this.getApprovalStatus();
+        }
+        catch (err) {
+            const error = normalizeError(err, "SDK_TRANSPORT_ERROR", "Could not read Pedelec approval status.");
+            return {
+                available: false,
+                extension: { available: !isExtensionUnavailableError(error) },
+                approval: { approved: false, origin },
+                desktop: { available: false, launchAttempted: false },
+                error,
+            };
+        }
+        if (!approval.installed) {
+            return {
+                available: false,
+                extension: { available: false },
+                approval: { approved: false, origin: approval.origin ?? origin },
+                desktop: { available: false, launchAttempted: false },
+            };
+        }
+        if (!approval.approved) {
+            return {
+                available: false,
+                extension: { available: true },
+                approval: { approved: false, origin: approval.origin },
+                desktop: { available: false, launchAttempted: false },
+            };
+        }
+        try {
+            await this.getSettings();
+            return {
+                available: true,
+                extension: { available: true },
+                approval: { approved: true, origin: approval.origin },
+                desktop: { available: true, launchAttempted: true },
+            };
+        }
+        catch (err) {
+            const error = normalizeError(err, "SDK_TRANSPORT_ERROR", "Could not reach Pedelec Desktop.");
+            return {
+                available: false,
+                extension: { available: true },
+                approval: { approved: true, origin: approval.origin },
+                desktop: { available: false, launchAttempted: true },
+                error,
+            };
+        }
+    }
     async resolveDefaultCreateSessionInput(normalizedSkills, autoEndOnDisconnect) {
         const settings = await this.getSettings();
         if (!settings.defaultProvider) {
@@ -908,6 +960,9 @@ function getCurrentOrigin(pageWindow) {
     const origin = pageWindow?.location?.origin;
     return typeof origin === "string" && origin ? origin : null;
 }
+function isExtensionUnavailableError(error) {
+    return error.code === "EXTENSION_UNAVAILABLE" || error.code === "EXTENSION_DISCONNECTED";
+}
 function normalizeError(err, fallbackCode, fallbackMessage) {
     if (!err)
         return makeError(fallbackCode, fallbackMessage);

package/dist/index.type-test.js

@@ -96,10 +96,18 @@ async function listAssetsHasPublicTypes() {
     const path = assets[0].path;
     path;
 }
+async function availabilityHasPublicType() {
+    const pedelec = new Pedelec();
+    const availability = await pedelec.checkAvailability();
+    const promise = pedelec.checkAvailability();
+    void availability;
+    void promise;
+}
 void typedOnToolNameFromCreateSession;
 void resumedSessionFallsBackToString;
 void noSkillsFallsBackToString;
 void listAssetsHasPublicTypes;
+void availabilityHasPublicType;
 const baseContext = {
     sessionId: "thread_1",
     provider: "codex",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaoruisaac/pedelec",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",