@kaoruisaac/pedelec 0.2.2 → 0.2.3

package/README.md

@@ -171,18 +171,22 @@ Pedelec creates missing `skills/`, `assets/`, `logs/`, and `tmp/` directories an
 
 ## Selecting an Application Workspace
 
-Use `directoryPicker()` when the application wants the user to choose a local workspace before creating a session:
+Use `sandboxFolderPicker()` 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 folder = await pedelec.sandboxFolderPicker();
+if (!folder) return; // The user cancelled the native picker.
+
+if (!folder.isEmptyFolder && !folder.hasSandboxConfig) {
+  // The application decides whether to warn the user.
+}
 
 const session = await pedelec.createSession({
-  sandbox: { path },
+  sandbox: { path: folder.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.
+`sandboxFolderPicker()` returns `Promise<SandboxFolderPickerResult | null>`. It is a read-only snapshot: it does not validate or initialize the selected folder, create workspace directories, or create the sandbox marker. `isEmptyFolder` only reports whether the selected folder root has any filesystem entry. `hasSandboxConfig` is true only when `.pedelec-sandbox.json` exists as a regular file; its JSON is not parsed. The picker requires the same origin approval as other sensitive Desktop APIs, and cancellation returns `null`. `createSession()` still applies the full sandbox rules and creates the marker after successful custom sandbox initialization. The marker currently records the SDK version and normalized caller origin but does not restrict reuse by origin or SDK version.
 
 ---
 

package/dist/index.d.ts

@@ -86,6 +86,11 @@ export type SerializableSkillsManifest = {
 export type CreateSessionSandboxInput = {
     path: string;
 };
+export interface SandboxFolderPickerResult {
+    path: string;
+    isEmptyFolder: boolean;
+    hasSandboxConfig: boolean;
+}
 type CreateSessionInputWithProvider<TTools extends readonly ToolDefinition[] = readonly ToolDefinition[]> = {
     provider: ProviderCode;
     effortLevel?: EffortLevel;
@@ -233,7 +238,7 @@ 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>;
+    sandboxFolderPicker(): Promise<SandboxFolderPickerResult | null>;
     listProviders(): Promise<ProviderInfo[]>;
     getSettings(): Promise<PedelecSettings>;
     getApprovalStatus(): Promise<ApprovalStatus>;

package/dist/index.js

@@ -1,4 +1,5 @@
 import { PEDELEC_EXTENSION_ID } from "./extension-id.js";
+import { SDK_VERSION } from "./version.generated.js";
 const SDK_EXTERNAL_PORT_NAME = "pedelec-sdk-external";
 const DEFAULT_BRIDGE_TIMEOUT_MS = 30_000;
 function normalizeListAssetsResponse(response) {
@@ -149,9 +150,9 @@ 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 sandboxFolderPicker() {
+        const result = await this.requestWithOptions("pick_sandbox_folder", {}, { timeoutMs: null });
+        return normalizeSandboxFolderPickerResponse(result);
     }
     async listProviders() {
         return normalizeProviderInfoList(await this.request("list_providers"));
@@ -201,7 +202,13 @@ export class Pedelec {
             return Promise.reject(normalizeError(err, "EXTENSION_UNAVAILABLE", "Pedelec extension is unavailable."));
         }
         const requestId = `sdk_${Date.now()}_${this.nextRequestNumber++}`;
-        const message = { channelId: this.channelId, type, requestId, ...payload };
+        const message = {
+            channelId: this.channelId,
+            type,
+            requestId,
+            ...payload,
+            ...(type === "create_session" ? { callerSdkVersion: SDK_VERSION } : {}),
+        };
         return new Promise((resolve, reject) => {
             const timeoutMs = options.timeoutMs === undefined ? this.bridgeTimeoutMs : options.timeoutMs;
             const timeoutId = timeoutMs === null
@@ -1026,15 +1033,22 @@ function normalizePedelecSettings(value) {
     }
     return { defaultProvider: value.defaultProvider };
 }
-function normalizeDirectoryPickerResponse(value) {
+function normalizeSandboxFolderPickerResponse(value) {
     if (!isPlainObject(value) || !("path" in value)) {
-        throw makeError("SDK_PROTOCOL_ERROR", "pick_directory response had an invalid shape");
+        throw makeError("SDK_PROTOCOL_ERROR", "pick_sandbox_folder 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");
+    if (path === null)
+        return null;
+    if (typeof path !== "string" || path.length === 0 ||
+        typeof value.isEmptyFolder !== "boolean" || typeof value.hasSandboxConfig !== "boolean") {
+        throw makeError("SDK_PROTOCOL_ERROR", "pick_sandbox_folder response had an invalid shape");
     }
-    return path;
+    return {
+        path,
+        isEmptyFolder: value.isEmptyFolder,
+        hasSandboxConfig: value.hasSandboxConfig,
+    };
 }
 function normalizeProviderInfoList(value) {
     if (!Array.isArray(value))

package/dist/index.type-test.js

@@ -136,10 +136,15 @@ async function availabilityHasPublicType() {
     void availability;
     void promise;
 }
-async function directoryPickerHasPublicType() {
+async function sandboxFolderPickerHasPublicType() {
     const pedelec = new Pedelec();
-    const path = pedelec.directoryPicker();
-    void path;
+    const result = pedelec.sandboxFolderPicker();
+    void result;
+}
+function directoryPickerIsRemoved() {
+    const pedelec = new Pedelec();
+    // @ts-expect-error directoryPicker was removed in favor of sandboxFolderPicker
+    pedelec.directoryPicker();
 }
 function publicSecurityTypesAreRestricted() {
     const status = {
@@ -159,7 +164,8 @@ void noSkillsFallsBackToString;
 void effortLevelPublicTypeContract;
 void listAssetsHasPublicTypes;
 void availabilityHasPublicType;
-void directoryPickerHasPublicType;
+void sandboxFolderPickerHasPublicType;
+void directoryPickerIsRemoved;
 void publicSecurityTypesAreRestricted;
 const baseContext = {
     sessionId: "thread_1",

package/dist/version.generated.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "0.2.3";

package/dist/version.generated.js

@@ -0,0 +1,2 @@
+// Generated from sdk/package.json. Do not edit manually.
+export const SDK_VERSION = "0.2.3";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaoruisaac/pedelec",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,8 +24,11 @@
     "directory": "sdk"
   },
   "scripts": {
+    "prebuild": "node scripts/generate-version.mjs",
     "build": "tsc -p tsconfig.json",
+    "pretest": "node scripts/generate-version.mjs",
     "test": "vitest run",
+    "pretype-test": "node scripts/generate-version.mjs",
     "type-test": "tsc -p tsconfig.type-test.json",
     "prepublishOnly": "npm run test && npm run type-test && npm run build"
   },