@yanlinglabs/winter-agent-sdk 0.0.40 → 0.0.43

package/dist/index.js

@@ -430,7 +430,8 @@ function toWireMcpServers(servers) {
       ...cfg.timeout !== undefined ? { timeout: cfg.timeout } : {},
       ...isWinterMcpServerInstance(cfg.instance) ? { tools: cfg.instance.listTools() } : {},
       ...cfg.toolNames !== undefined ? { toolNames: { ...cfg.toolNames } } : {},
-      ...cfg.toolLanes !== undefined ? { toolLanes: { ...cfg.toolLanes } } : {}
+      ...cfg.toolLanes !== undefined ? { toolLanes: { ...cfg.toolLanes } } : {},
+      ...Array.isArray(cfg.concurrentTools) ? { concurrentTools: [...cfg.concurrentTools] } : {}
     } : cfg;
   }
   return out;
@@ -1270,32 +1271,38 @@ function withTestKeychainRedirect(env) {
   return { ...env, [TEST_KEYCHAIN_ENV]: redirect };
 }
 // src/version.ts
-var SDK_VERSION = "0.0.40";
+var SDK_VERSION = "0.0.43";
 // src/paths/project-key.ts
 var TRANSCRIPT_PROJECT_KEY_MAX_LENGTH = 64;
 var VENDOR_PROJECT_KEY_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
 function isVendorCompliantProjectKey(key) {
   return VENDOR_PROJECT_KEY_PATTERN.test(key);
 }
-function sanitize(absPath) {
-  return absPath.replace(/[^a-zA-Z0-9]/g, "-");
+function isAsciiAlphanumeric(code) {
+  return code >= 48 && code <= 57 || code >= 65 && code <= 90 || code >= 97 && code <= 122;
 }
-function rollingHash32(raw) {
-  let hash = 0;
-  for (let i = 0;i < raw.length; i++) {
-    hash = (hash << 5) - hash + raw.charCodeAt(i) | 0;
+function sanitizeForKey(text) {
+  let out = "";
+  for (let i = 0;i < text.length; i++) {
+    const code = text.charCodeAt(i);
+    out += isAsciiAlphanumeric(code) ? text[i] : "-";
   }
-  return hash;
+  return out;
 }
-function overflowSuffix(rawAbsPath) {
-  return Math.abs(rollingHash32(rawAbsPath)).toString(36);
+function hashSuffix(text) {
+  let hash = 0;
+  for (let i = 0;i < text.length; i++) {
+    hash = Math.imul(hash, 31) + text.charCodeAt(i) | 0;
+  }
+  return Math.abs(hash).toString(36);
 }
 function transcriptProjectKey(absPath) {
-  const sanitized = sanitize(absPath);
+  const sanitized = sanitizeForKey(absPath);
   if (sanitized.length <= TRANSCRIPT_PROJECT_KEY_MAX_LENGTH)
     return sanitized;
-  const suffix = overflowSuffix(absPath);
-  return sanitized.slice(0, TRANSCRIPT_PROJECT_KEY_MAX_LENGTH - 1 - suffix.length) + "-" + suffix;
+  const suffix = hashSuffix(absPath);
+  const prefixLength = TRANSCRIPT_PROJECT_KEY_MAX_LENGTH - 1 - suffix.length;
+  return `${sanitized.slice(0, prefixLength)}-${suffix}`;
 }
 // src/paths/keys.ts
 import { realpathSync } from "node:fs";
@@ -2052,52 +2059,52 @@ import { CATALOG_TAG_RENAMES } from "@yanlinglabs/winter-provider-catalog";
 
 // src/plugins/manage.ts
 import { mkdir, open, readFile as readFile2, rename, rmdir, unlink, writeFile } from "node:fs/promises";
-import { dirname as dirname3, isAbsolute as isAbsolute2, join as join3, resolve as resolve2 } from "node:path";
+import { dirname as dirname3, isAbsolute as isAbsolute2, join as join3, resolve } from "node:path";
 import { randomBytes } from "node:crypto";
 
 // src/plugins/marketplace-path.ts
-import { resolve, sep } from "node:path";
-var BARE_SOURCE_NAME = /^[A-Za-z0-9][-A-Za-z0-9._]*$/;
-function isBareSourceName(source) {
-  return BARE_SOURCE_NAME.test(source) && !source.includes("..");
-}
-function normalizePluginRoot(pluginRoot) {
-  if (typeof pluginRoot !== "string" || pluginRoot === "" || pluginRoot.startsWith("/") || pluginRoot.includes("\\") || pluginRoot.includes(":"))
+import path from "node:path";
+var MARKETPLACE_DIR = Symbol("marketplace-dir");
+function usableRoot(pluginRoot) {
+  if (typeof pluginRoot !== "string")
     return;
-  const stripped = pluginRoot.replace(/^\.\//, "").replace(/\/+$/, "");
-  if (stripped === "" || stripped === ".")
-    return ".";
-  if (stripped.split("/").some((segment) => segment === "" || segment === "." || segment === ".."))
+  if (pluginRoot === "" || pluginRoot.startsWith("/"))
     return;
-  return stripped;
-}
-function withPluginRootPrefix(source, normalizedRoot) {
-  if (normalizedRoot === undefined || !isBareSourceName(source))
-    return source;
-  return normalizedRoot === "." ? `./${source}` : `./${normalizedRoot}/${source}`;
-}
-function schemaSourcePath(source) {
-  const normalized = source === "." ? "./" : source;
-  return normalized.startsWith("./") ? normalized : undefined;
-}
-function resolveWithinBase(base, relativePath) {
-  const normalizedBase = resolve(base);
-  const resolved = resolve(base, relativePath);
-  if (resolved !== normalizedBase && !resolved.startsWith(normalizedBase + sep)) {
-    throw new Error(`Path traversal detected: "${relativePath}" would escape the base directory`);
+  if (pluginRoot.includes("\\") || pluginRoot.includes(":"))
+    return;
+  let rest = pluginRoot.startsWith("./") ? pluginRoot.slice(2) : pluginRoot;
+  rest = rest.replace(/\/+$/, "");
+  if (rest === "" || rest === ".")
+    return MARKETPLACE_DIR;
+  for (const piece of rest.split("/")) {
+    if (piece === "" || piece === "." || piece === "..")
+      return;
   }
-  return resolved;
+  return rest;
+}
+function isBareName(source) {
+  return /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(source) && !source.includes("..");
 }
 function resolveMarketplacePluginPath(installLocation, pluginRoot, source) {
-  if (typeof source !== "string" || source === "")
-    return;
-  const normalizedRoot = normalizePluginRoot(pluginRoot);
-  const prefixed = withPluginRootPrefix(source, normalizedRoot);
-  const sourcePath = schemaSourcePath(prefixed);
-  if (sourcePath === undefined)
-    return;
   try {
-    return resolveWithinBase(installLocation, sourcePath);
+    if (typeof source !== "string" || source === "")
+      return;
+    let relativePath = source;
+    if (isBareName(source)) {
+      const root = usableRoot(pluginRoot);
+      if (root !== undefined) {
+        relativePath = root === MARKETPLACE_DIR ? `./${source}` : `./${root}/${source}`;
+      }
+    }
+    if (relativePath === ".")
+      relativePath = "./";
+    if (!relativePath.startsWith("./"))
+      return;
+    const base = path.resolve(installLocation);
+    const candidate = path.resolve(installLocation, relativePath);
+    if (candidate === base || candidate.startsWith(base + path.sep))
+      return candidate;
+    return;
   } catch {
     return;
   }
@@ -2243,7 +2250,7 @@ function classifySource(source) {
   if (/^[a-zA-Z0-9](?:[a-zA-Z0-9._-]*[a-zA-Z0-9])?\/[a-zA-Z0-9](?:[a-zA-Z0-9._-]*[a-zA-Z0-9])?$/.test(source) && !source.includes("..")) {
     return { kind: "github", locator: source };
   }
-  return { kind: "directory", locator: isAbsolute2(source) ? source : resolve2(source) };
+  return { kind: "directory", locator: isAbsolute2(source) ? source : resolve(source) };
 }
 function marketplaceInfoOf(name, record) {
   const kind = record.source.source;

package/dist/paths/project-key.d.ts

@@ -1,3 +1,4 @@
 export declare const TRANSCRIPT_PROJECT_KEY_MAX_LENGTH = 64;
 export declare function isVendorCompliantProjectKey(key: string): boolean;
+/** The transcript project key for an absolute path. */
 export declare function transcriptProjectKey(absPath: string): string;

package/dist/plugins/marketplace-path.d.ts

@@ -1,10 +1 @@
-/**
- * Resolve one marketplace manifest plugin entry's install path -- the ONE function
- * `packages/runtime/src/plugins/installed.ts` (the daemon's own directory-marketplace fallback,
- * SV-4) and `packages/sdk/src/plugins/manage.ts` (`resolvePluginSourcePath`, the CLI-facing install
- * command) both call, so the two can never resolve the identical manifest entry to two different
- * paths. `undefined` for anything invalid or refused -- a bare name with no usable `pluginRoot`, an
- * absolute/malformed source, or a path that would escape `installLocation` -- NEVER a throw a
- * caller must remember to catch; each caller renders its own typed rejection from `undefined`.
- */
 export declare function resolveMarketplacePluginPath(installLocation: string, pluginRoot: unknown, source: unknown): string | undefined;

package/dist/protocol/config.d.ts

@@ -406,6 +406,23 @@ export interface McpSdkServerConfig {
      * ignored. Only an in-process (`sdk`) server may declare lanes; the host vouches for its own tools.
      */
     toolLanes?: Record<string, string>;
+    /**
+     * SDK 0.0.41, a Winter extension: some of this server's tools, by the server's own tool name, that are
+     * SAFE TO RUN CONCURRENTLY without being read-only (`["session_spawn"]`). A round's calls normally run
+     * one at a time unless the tool is read-only (`readOnlyHint: true`); a tool listed here runs BESIDE the
+     * round's other concurrent calls (up to 10 at once), exactly like a read-only one -- several calls of it
+     * in one round run at the same time (claude runs several `Agent` calls of a round at once; this is the
+     * same thing for a host tool that starts work elsewhere).
+     *
+     * It is a SCHEDULING statement only. It never makes the tool read-only anywhere else: the tool's
+     * `annotations` are not touched, plan mode, permission evaluation, the hook input's `winter_mcp_server`
+     * and `canUseTool`'s `mcpServer` read the server's own `readOnlyHint` exactly as before. Use it only for a
+     * tool whose concurrent calls cannot interfere with each other (each call's work is its own); a tool
+     * that holds one exclusive resource belongs in a lane (`toolLanes`) instead. A tool named in BOTH is in
+     * its lane (the stricter answer). An entry that is not a string, or names no tool of this server, is
+     * ignored. Only an in-process (`sdk`) server may declare it; the host vouches for its own tools.
+     */
+    concurrentTools?: string[];
 }
 export type McpServerConfigForProcessTransport = McpStdioServerConfig | McpHttpServerConfig | McpSSEServerConfig | McpSdkServerConfig;
 export type AgentMcpServerSpec = string | Record<string, McpServerConfigForProcessTransport>;

package/dist/settings/types.d.ts

@@ -69,12 +69,10 @@ export interface Settings {
      * `permissions.deny`'s own union exists to prevent; see `unionSandboxFilesystemDenyArrays` below).
      * CORRECTED in fix round 10, item C: round 9 reasoned `allowWrite` should NOT union (a widening
      * key should never accumulate) and used the ordinary replace-by-higher-tier merge for it instead
-     * -- the controller's round-10 ruling reverses this, dump-confirmed against claude's own live
-     * sandbox-reconciliation code unioning its OWN rule-derived allowWrite set with the native
-     * sandbox's currently-configured one (`xr=se([...yr,...$r.filter(...)])`, not a replacement).
-     * Claude itself unions the widening array too; ported here to match. `allowRead` (also new this
-     * round) is claude's own read carve-out (`getFsReadConfig`'s `allowWithinDeny`) -- carried and
-     * unioned identically for merge-parity, though `packages/runtime/src/sandbox/profile.ts`'s own
+     * -- the controller's round-10 ruling reverses this: Claude Code accumulates allowWrite entries
+     * from every source rather than letting one replace another, so Winter unions the widening array
+     * too. `allowRead` (also new this round) is the settings key for re-permitting reads inside a
+     * denied region -- carried and unioned identically for merge-parity, though `packages/runtime/src/sandbox/profile.ts`'s own
      * `buildSeatbeltProfile` does not yet enforce it (a disclosed, fails-CLOSED gap: see that file's
      * own `SandboxFilesystemSettings.allowRead` doc comment).
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanlinglabs/winter-agent-sdk",
-  "version": "0.0.40",
+  "version": "0.0.43",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -45,15 +45,15 @@
     }
   },
   "dependencies": {
-    "@yanlinglabs/winter-provider-catalog": "0.0.40"
+    "@yanlinglabs/winter-provider-catalog": "0.0.43"
   },
   "optionalDependencies": {
-    "@yanlinglabs/winter-agent-sdk-darwin-arm64": "0.0.40"
+    "@yanlinglabs/winter-agent-sdk-darwin-arm64": "0.0.43"
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
-    "@yanlinglabs/winter-agent-runtime": "0.0.40",
-    "@yanlinglabs/winter-conformance": "0.0.40"
+    "@yanlinglabs/winter-agent-runtime": "0.0.43",
+    "@yanlinglabs/winter-conformance": "0.0.43"
   },
   "scripts": {}
 }