@kaoruisaac/pedelec 0.2.1 → 0.2.2

package/README.md

@@ -24,6 +24,7 @@ Pedelec is a browser SDK and local bridge for applications that want to work wit
 A web application can use Pedelec to:
 
 - create an agent session on the user's machine;
+- choose an application-managed workspace with the native directory picker;
 - send user instructions and receive streamed assistant text;
 - expose narrowly scoped browser-side tools to the agent;
 - resume or end sessions; and
@@ -168,6 +169,21 @@ const session = await pedelec.createSession({
 
 Pedelec creates missing `skills/`, `assets/`, `logs/`, and `tmp/` directories and preserves existing files. It never deletes an explicit workspace, and multiple active sessions may share it. Filesystem write conflicts are the application's responsibility. An explicit path must not overlap Pedelec's managed sandbox root.
 
+## Selecting an Application Workspace
+
+Use `directoryPicker()` when the application wants the user to choose a local workspace before creating a session:
+
+```ts
+const path = await pedelec.directoryPicker();
+if (path === null) return; // The user cancelled the native picker.
+
+const session = await pedelec.createSession({
+  sandbox: { path },
+});
+```
+
+`directoryPicker()` returns `Promise<string | null>` and does not validate or initialize the selected directory. It requires the same origin approval as other sensitive Desktop APIs. The selected path remains application-managed; existing Core sandbox rules are applied later by `createSession()`, which may return `SANDBOX_PATH_INVALID` for an unacceptable path.
+
 ---
 
 ## Creating a Session

package/dist/index.d.ts

@@ -233,11 +233,13 @@ export declare class Pedelec {
     constructor(options?: PedelecOptions);
     createSession(): Promise<PedelecSession<string>>;
     createSession<const TTools extends readonly ToolDefinition[]>(input: CreateSessionInput<TTools>): Promise<PedelecSession<ToolNameOf<TTools>>>;
+    directoryPicker(): Promise<string | null>;
     listProviders(): Promise<ProviderInfo[]>;
     getSettings(): Promise<PedelecSettings>;
     getApprovalStatus(): Promise<ApprovalStatus>;
     resumeSession(sessionId: string): Promise<PedelecSession<string>>;
     request<T>(type: string, payload?: Record<string, unknown>): Promise<T>;
+    private requestWithOptions;
     unregisterSession(sessionId: string): void;
     private resolveCreateSessionInput;
     checkAvailability(): Promise<PedelecAvailability>;

package/dist/index.js

@@ -149,6 +149,10 @@ export class Pedelec {
         }
         return this.registerSession(result.sessionId, resolvedInput.provider, resolvedInput.effortLevel, resolvedInput.inlineToolHandlers);
     }
+    async directoryPicker() {
+        const result = await this.requestWithOptions("pick_directory", {}, { timeoutMs: null });
+        return normalizeDirectoryPickerResponse(result);
+    }
     async listProviders() {
         return normalizeProviderInfoList(await this.request("list_providers"));
     }
@@ -186,6 +190,9 @@ export class Pedelec {
         return this.registerSession(result.sessionId, "", undefined);
     }
     request(type, payload = {}) {
+        return this.requestWithOptions(type, payload);
+    }
+    requestWithOptions(type, payload = {}, options = {}) {
         let port;
         try {
             port = this.ensureExtensionPort();
@@ -196,13 +203,16 @@ export class Pedelec {
         const requestId = `sdk_${Date.now()}_${this.nextRequestNumber++}`;
         const message = { channelId: this.channelId, type, requestId, ...payload };
         return new Promise((resolve, reject) => {
-            const timeoutId = setTimeout(() => {
-                this.pendingRequests.delete(requestId);
-                reject(makeError("SDK_BRIDGE_TIMEOUT", "Pedelec extension did not respond.", {
-                    requestId,
-                    type,
-                }));
-            }, this.bridgeTimeoutMs);
+            const timeoutMs = options.timeoutMs === undefined ? this.bridgeTimeoutMs : options.timeoutMs;
+            const timeoutId = timeoutMs === null
+                ? null
+                : setTimeout(() => {
+                    this.pendingRequests.delete(requestId);
+                    reject(makeError("SDK_BRIDGE_TIMEOUT", "Pedelec extension did not respond.", {
+                        requestId,
+                        type,
+                    }));
+                }, timeoutMs);
             this.pendingRequests.set(requestId, {
                 port,
                 resolve: (value) => resolve(value),
@@ -214,7 +224,8 @@ export class Pedelec {
             }
             catch (err) {
                 this.pendingRequests.delete(requestId);
-                clearTimeout(timeoutId);
+                if (timeoutId !== null)
+                    clearTimeout(timeoutId);
                 const error = normalizeError(err, "EXTENSION_DISCONNECTED", "Pedelec extension disconnected.");
                 if (this.port === port) {
                     this.handleDisconnect(port, error);
@@ -398,7 +409,8 @@ export class Pedelec {
         if (!pending)
             return;
         this.pendingRequests.delete(message.requestId);
-        clearTimeout(pending.timeoutId);
+        if (pending.timeoutId !== null)
+            clearTimeout(pending.timeoutId);
         if (message.ok) {
             pending.resolve(message.result);
         }
@@ -427,7 +439,8 @@ export class Pedelec {
             if (pending.port !== port)
                 continue;
             this.pendingRequests.delete(requestId);
-            clearTimeout(pending.timeoutId);
+            if (pending.timeoutId !== null)
+                clearTimeout(pending.timeoutId);
             pending.reject(error);
         }
     }
@@ -1013,6 +1026,16 @@ function normalizePedelecSettings(value) {
     }
     return { defaultProvider: value.defaultProvider };
 }
+function normalizeDirectoryPickerResponse(value) {
+    if (!isPlainObject(value) || !("path" in value)) {
+        throw makeError("SDK_PROTOCOL_ERROR", "pick_directory response had an invalid shape");
+    }
+    const path = value.path;
+    if (path !== null && (typeof path !== "string" || path.length === 0)) {
+        throw makeError("SDK_PROTOCOL_ERROR", "pick_directory response had an invalid shape");
+    }
+    return path;
+}
 function normalizeProviderInfoList(value) {
     if (!Array.isArray(value))
         throw makeError("SDK_PROTOCOL_ERROR", "list_providers response was not an array");

package/dist/index.type-test.js

@@ -136,6 +136,11 @@ async function availabilityHasPublicType() {
     void availability;
     void promise;
 }
+async function directoryPickerHasPublicType() {
+    const pedelec = new Pedelec();
+    const path = pedelec.directoryPicker();
+    void path;
+}
 function publicSecurityTypesAreRestricted() {
     const status = {
         installed: true,
@@ -154,6 +159,7 @@ void noSkillsFallsBackToString;
 void effortLevelPublicTypeContract;
 void listAssetsHasPublicTypes;
 void availabilityHasPublicType;
+void directoryPickerHasPublicType;
 void publicSecurityTypesAreRestricted;
 const baseContext = {
     sessionId: "thread_1",

package/package.json

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