opencode-readseek 0.9.13 → 0.9.14

package/README.md

@@ -1,13 +1,11 @@
 # opencode-readseek
 
-<img alt="OpenCode running opencode-readseek" src="screenshot.png" width="800">
-
-`opencode-readseek` adds anchored file operations, structural search, symbol
-navigation, and document tools to OpenCode.
+OpenCode plugin for anchored edits, structural search, symbol navigation, and
+document inspection.
 
 ## Install
 
-Add the package to `opencode.json`:
+Add the plugin to `opencode.json`:
 
 ```json
 {
@@ -15,38 +13,16 @@ Add the package to `opencode.json`:
 }
 ```
 
-OpenCode installs the package and its platform-specific
-`@jarkkojs/readseek` dependency with Bun.
+The plugin uses the native binary supplied by `@jarkkojs/readseek`. Set
+`READSEEK_BINARY` to an absolute executable path to override it.
 
 ## Tools
 
-| Tool               | Purpose                                                                 |
-| ------------------ | ----------------------------------------------------------------------- |
-| `readseek_edit`    | Apply hash-verified edits to an existing text file                      |
-| `readseek_write`   | Create or replace a complete text file                                  |
-| `readseek_grep`    | Search text or regex and return anchors                                 |
-| `readseek_digest`  | Native digest envelope: metadata, content, map, diagnostics, identity   |
-| `readseek_search`  | Search AST patterns                                                     |
-| `readseek_def`     | Find symbol definitions                                                 |
-| `readseek_refs`    | Find identifier usages, optionally scoped to a cursor binding           |
-| `readseek_rename`  | Apply a binding-aware rename; set `apply: false` for a dry run          |
-| `readseek_view`    | View or narrow a structural document index                              |
-
-The plugin requests read, grep, external-directory, and edit permissions as
-needed. Mutations invalidate remembered anchors; compaction preserves fresh
-paths and pending rename plans. Text reads return at most 2,000 lines by
-default.
-
-OpenCode is instructed to prefer ReadSeek over the built-in `read`, `edit`,
-`write`, `grep`, and `apply_patch` tools when ReadSeek can do the job. Built-ins
-remain available as fallbacks.
-
-Documents such as PDFs are owned by `readseek_view`. Calling `readseek_digest`
-on a document returns a cache receipt and directs the caller to `readseek_view`.
+`readseek_edit`, `readseek_write`, `readseek_grep`, `readseek_digest`,
+`readseek_search`, `readseek_def`, `readseek_refs`, `readseek_rename`, and
+`readseek_view`.
 
-## Configuration
-
-Pass options with OpenCode's plugin tuple syntax:
+To control image handling:
 
 ```json
 {
@@ -54,15 +30,7 @@ Pass options with OpenCode's plugin tuple syntax:
 }
 ```
 
-`imageMode` accepts:
-
-- `"auto"` (default): expose `none`, `all`, `ocr`, `caption`, and `objects`.
-- `"on"`: expose local analysis modes and omit `none`.
-- `"off"`: skip image reads.
-
-Omitting `image` from a read also skips image files. Document asset analysis
-uses `readseek_view` with optional `visionMode` (`all` | `ocr` | `caption` |
-`objects`) and `visionLevel` (`low` | `medium` | `high`).
+`imageMode` is `auto` (default), `on`, or `off`.
 
 ## Development
 
@@ -72,8 +40,7 @@ bun test
 bun run typecheck
 ```
 
-## License
 
-`opencode-readseek` is Apache-2.0; see [LICENSE](LICENSE).
-`@jarkkojs/readseek` is licensed separately under
-Apache-2.0 AND LGPL-2.1-or-later.
+## Licensing
+
+[Apache 2.0](../../LICENSE-APACHE-2.0).

package/dist/index.js

@@ -3,8 +3,6 @@ import path7 from "node:path";
 
 // src/client.ts
 import { createRequire as createRequire2 } from "node:module";
-import { homedir } from "node:os";
-import path3 from "node:path";
 import { stat } from "node:fs/promises";
 
 // ../readseek-api/src/contract.ts
@@ -23,6 +21,13 @@ var DOCUMENT_NODE_KINDS = [
   "section",
   "structural_section"
 ];
+var EDIT_VARIANTS = [
+  "set_line",
+  "replace_lines",
+  "insert_after",
+  "replace",
+  "replace_symbol"
+];
 var TOOL_NAMES = [
   "digest",
   "edit",
@@ -478,6 +483,24 @@ function fallbackToolDescriptionMap(builtIns = Object.keys(BUILTIN_FALLBACKS), a
     return description ? [[builtIn, description]] : [];
   }));
 }
+// ../readseek-api/src/hashline.ts
+var LINE_ANCHOR_RE = /^(\d+):([0-9a-fA-F]{6})$/;
+function tryParseLineAnchor(anchor) {
+  const match = LINE_ANCHOR_RE.exec(anchor.trim());
+  if (!match) {
+    return { ok: false, error: `invalid LINE:HASH anchor: ${anchor}` };
+  }
+  const digits = match[1];
+  const line = Number.parseInt(digits, 10);
+  if (!Number.isSafeInteger(line)) {
+    return { ok: false, error: `Line number must be a safe integer, got ${digits} in "${anchor}".` };
+  }
+  if (line < 1) {
+    return { ok: false, error: `Line number must be >= 1, got ${line} in "${anchor}".` };
+  }
+  return { ok: true, anchor: { line, hash: match[2].toLowerCase() } };
+}
+
 // ../readseek-api/src/validation.ts
 function validateGitSelection(input) {
   if (input.ignored && !input.others) {
@@ -509,6 +532,73 @@ function validateVisionLevelVsMode(input) {
   }
   return { ok: true };
 }
+var VARIANT_FIELDS = {
+  set_line: ["anchor", "new_text"],
+  replace_lines: ["start_anchor", "end_anchor", "new_text"],
+  insert_after: ["anchor", "new_text"],
+  replace: ["old_text", "new_text"],
+  replace_symbol: ["symbol", "new_body"]
+};
+function isEditVariant(value) {
+  return EDIT_VARIANTS.includes(value);
+}
+function parseEditItem(item, index) {
+  const keys = Object.keys(item);
+  const variant = keys[0];
+  if (keys.length !== 1 || variant === undefined || !isEditVariant(variant)) {
+    return {
+      ok: false,
+      error: `edits[${index}] must contain exactly one of: ${EDIT_VARIANTS.join(", ")}. Got: [${keys.join(", ")}]`
+    };
+  }
+  const payload = item[variant];
+  if (!payload || typeof payload !== "object" || Array.isArray(payload)) {
+    return { ok: false, error: `edits[${index}].${variant} must be an object` };
+  }
+  const expected = VARIANT_FIELDS[variant];
+  const allowed = variant === "replace" ? [...expected, "all"] : [...expected];
+  const actual = Object.keys(payload);
+  if (actual.some((field) => !allowed.includes(field)) || expected.some((field) => !actual.includes(field))) {
+    return { ok: false, error: `edits[${index}].${variant} contains invalid fields` };
+  }
+  const values = payload;
+  for (const field of expected) {
+    if (typeof values[field] !== "string") {
+      return { ok: false, error: `edits[${index}].${variant}.${field} must be a string` };
+    }
+  }
+  if (variant === "replace" && values.all !== undefined && typeof values.all !== "boolean") {
+    return { ok: false, error: `edits[${index}].replace.all must be a boolean` };
+  }
+  for (const field of expected) {
+    if (!field.endsWith("anchor"))
+      continue;
+    const parsed = tryParseLineAnchor(values[field]);
+    if (!parsed.ok) {
+      return { ok: false, error: `edits[${index}].${variant}.${field}: ${parsed.error}` };
+    }
+  }
+  return { ok: true, edit: item };
+}
+function validateExactlyOneEditVariant(edits) {
+  if (!Array.isArray(edits) || edits.length === 0) {
+    return { ok: false, error: "edits must contain at least one edit" };
+  }
+  const normalized = [];
+  for (let index = 0;index < edits.length; index++) {
+    const item = edits[index];
+    if (!item || typeof item !== "object" || Array.isArray(item)) {
+      return { ok: false, error: `edits[${index}] must be an edit object` };
+    }
+    const parsed = parseEditItem(item, index);
+    if (!parsed.ok)
+      return parsed;
+    normalized.push(parsed.edit);
+  }
+  return { ok: true, edits: normalized };
+}
+var MIN_SAFE_INTEGER = BigInt(Number.MIN_SAFE_INTEGER);
+var MAX_SAFE_INTEGER = BigInt(Number.MAX_SAFE_INTEGER);
 // ../readseek-api/src/argv.ts
 function buildLineLocation(line, column) {
   return column === undefined ? `line:${line}` : `line:${line}:${column}`;
@@ -518,14 +608,12 @@ function appendGitSelectionArgs(args, input) {
   if (!validated.ok) {
     throw new Error(validated.error);
   }
-  const selection = [
-    input.cached ? "cached" : undefined,
-    input.others ? "others" : undefined,
-    input.ignored ? "ignored" : undefined
-  ].filter((value) => value !== undefined);
-  if (selection.length > 0) {
-    args.push("--git", selection.join(","));
-  }
+  if (input.cached)
+    args.push("--cached");
+  if (input.others)
+    args.push("--others");
+  if (input.ignored)
+    args.push("--ignored");
   return args;
 }
 function pushOptionalString(args, flag, value) {
@@ -602,15 +690,17 @@ function buildViewArgs(input) {
   return args;
 }
 function buildSearchArgs(input) {
-  const args = ["search", input.path, input.pattern];
+  const args = ["search", input.pattern];
+  pushOptionalString(args, "--path", input.path);
   pushOptionalString(args, "--language", input.language);
+  pushOptionalNumber(args, "--limit", input.limit);
   return appendGitSelectionArgs(args, input);
 }
 function buildDefArgs(input) {
-  const args = ["def", input.path];
+  const args = ["def", input.name];
+  pushOptionalString(args, "--path", input.path);
   if (input.format !== undefined)
     args.push("--format", input.format);
-  args.push(input.name);
   pushOptionalString(args, "--language", input.language);
   return appendGitSelectionArgs(args, input);
 }
@@ -618,11 +708,14 @@ function buildRefsArgs(input) {
   const validated = validateRefsNameVsScope(input);
   if (!validated.ok)
     throw new Error(validated.error);
-  const args = ["refs", input.path];
-  if (input.scope) {
-    args.push("--at", buildLineLocation(input.line, input.column));
-  } else if (input.name !== undefined) {
+  const args = ["refs"];
+  if (input.name !== undefined)
     args.push(input.name);
+  pushOptionalString(args, "--path", input.path);
+  if (input.scope) {
+    args.push("--scope");
+    pushOptionalNumber(args, "--line", input.line);
+    pushOptionalNumber(args, "--column", input.column);
   }
   if (input.format !== undefined)
     args.push("--format", input.format);
@@ -638,13 +731,13 @@ function buildEditArgs(input) {
   });
   pushOptionalString(args, "--language", input.language);
   if (input.requestFromStdin)
-    args.push("--request", "-");
+    args.push("--edits", "-");
   return args;
 }
 function buildRenameArgs(input) {
   const args = ["rename", input.path, "--at", buildLineLocation(input.line, input.column), "--to", input.to];
   if (input.workspace !== undefined)
-    args.push("--workspace", input.workspace);
+    args.push(`--workspace=${input.workspace}`);
   appendApplyAndPlanHash(args, {
     apply: input.apply,
     planHash: input.planHash,
@@ -654,9 +747,11 @@ function buildRenameArgs(input) {
   return appendGitSelectionArgs(args, input);
 }
 // ../readseek-api/src/platform.ts
-import { accessSync, constants as fsConstants } from "node:fs";
+import { accessSync, constants as fsConstants, existsSync, statSync } from "node:fs";
 import { createRequire } from "node:module";
+import { homedir } from "node:os";
 import path from "node:path";
+var READSEEK_BINARY_ENV = "READSEEK_BINARY";
 var READSEEK_PLATFORM_PACKAGES = {
   "darwin-arm64": "@jarkkojs/readseek-darwin-arm64",
   "linux-arm64": "@jarkkojs/readseek-linux-arm64",
@@ -670,6 +765,24 @@ function readSeekBinaryName(platform = process.platform) {
 function readSeekPlatformKey(platform = process.platform, arch = process.arch) {
   return `${platform}-${arch}`;
 }
+function resolveReadSeekBinaryOverride(environment = process.env) {
+  const binaryPath = environment[READSEEK_BINARY_ENV];
+  if (binaryPath === undefined)
+    return null;
+  if (!path.isAbsolute(binaryPath)) {
+    throw new Error(`${READSEEK_BINARY_ENV} must be an absolute path to the readseek executable`);
+  }
+  try {
+    if (!statSync(binaryPath).isFile())
+      throw new Error("not a regular file");
+    accessSync(binaryPath, fsConstants.X_OK);
+  } catch (error) {
+    throw new Error(`${READSEEK_BINARY_ENV} does not point to an executable file: ${binaryPath}`, {
+      cause: error
+    });
+  }
+  return binaryPath;
+}
 function resolveReadSeekBinaryFromPackages(resolver = resolveFromPackage, options = {}) {
   const resolve = typeof resolver === "function" ? resolver : resolver.resolve.bind(resolver);
   const platform = options.platform ?? process.platform;
@@ -695,6 +808,37 @@ function resolveReadSeekBinaryFromPackages(resolver = resolveFromPackage, option
   accessSync(binaryPath, fsConstants.X_OK);
   return binaryPath;
 }
+function resolveReadSeekCacheDir(subPath, options = {}) {
+  const env = options.environment ?? process.env;
+  const platform = options.platform ?? process.platform;
+  const home = options.homedir ? options.homedir() : homedir();
+  const cwd = options.cwd ?? process.cwd();
+  const localDirName = options.localDirName ?? ".readseek";
+  if (localDirName && localDirName.length > 0) {
+    const local = path.join(cwd, localDirName);
+    if (existsSync(local))
+      return local;
+  }
+  let base;
+  if (platform === "win32") {
+    base = env.LOCALAPPDATA ?? path.join(home, "AppData", "Local");
+  } else {
+    const xdg = env.XDG_CACHE_HOME?.trim();
+    base = xdg && path.isAbsolute(xdg) ? xdg : path.join(home, ".cache");
+  }
+  const pathModule = platform === "win32" ? path.win32 : path;
+  if (subPath === undefined) {
+    return pathModule.join(base, "readseek");
+  }
+  const parts = Array.isArray(subPath) ? subPath : [subPath];
+  return pathModule.join(base, ...parts);
+}
+// ../readseek-api/src/path.ts
+import path2 from "node:path";
+function isSubPath(parent, candidate) {
+  const relative = path2.relative(parent, candidate);
+  return relative === "" || !relative.startsWith(`..${path2.sep}`) && relative !== ".." && !path2.isAbsolute(relative);
+}
 // ../readseek-api/src/json.ts
 var READSEEK_USAGE_HINT = /\n\s*Run readseek(?: [\w-]+)* --help for more information\.?\s*$/;
 function cleanReadSeekErrorText(stderr) {
@@ -847,7 +991,7 @@ var VISION_LEVEL_VALUES = [...VISION_LEVELS];
 var DOCUMENT_NODE_KIND_VALUES = [...DOCUMENT_NODE_KINDS];
 
 // src/util.ts
-import path2 from "node:path";
+import path3 from "node:path";
 function render(value) {
   return JSON.stringify(value, null, 2);
 }
@@ -885,11 +1029,11 @@ function renameFiles(value) {
   const output = record(value);
   const files = [];
   if (typeof output.file === "string" && items(output.edits).length > 0)
-    files.push(path2.resolve(output.file));
+    files.push(path3.resolve(output.file));
   for (const other of items(output.others)) {
     const item = record(other);
     if (typeof item.file === "string" && items(item.edits).length > 0)
-      files.push(path2.resolve(item.file));
+      files.push(path3.resolve(item.file));
   }
   return files;
 }
@@ -960,7 +1104,7 @@ function readRangeArgs(filePath, start, end) {
   return digestArgs(filePath, "content", extra);
 }
 function readSeekBinaryPath() {
-  return resolveReadSeekBinaryFromPackages(resolveFromHost);
+  return resolveReadSeekBinaryOverride() ?? resolveReadSeekBinaryFromPackages(resolveFromHost);
 }
 async function preserveAbortReason(signal, cancelable, invoke) {
   try {
@@ -1015,9 +1159,7 @@ async function postMutationPreview(context, args, filePath, changed) {
 }
 var readSeekCacheInit;
 function readSeekCacheDir() {
-  const xdgCacheHome = process.env.XDG_CACHE_HOME?.trim();
-  const cacheHome = xdgCacheHome || path3.join(homedir(), ".cache");
-  return path3.join(cacheHome, "opencode", "readseek");
+  return resolveReadSeekCacheDir(["opencode", "readseek"], { localDirName: "" });
 }
 async function ensureReadSeekCache(context) {
   const cacheDir = readSeekCacheDir();
@@ -1154,55 +1296,10 @@ async function withFileMutationQueue(filePath, operation) {
       fileMutationTails.delete(key);
   }
 }
-function parseAnchor(anchor) {
-  const match = /^(\d+):([0-9a-fA-F]{3})$/.exec(anchor.trim());
-  if (!match)
-    throw new Error(`invalid LINE:HASH anchor: ${anchor}`);
-  const line = Number(match[1]);
-  if (line === 0)
-    throw new Error(`anchor line must be greater than zero: ${anchor}`);
-  return { line, hash: match[2].toLowerCase() };
-}
 function validateEdits(value) {
-  if (!Array.isArray(value) || value.length === 0)
-    throw new Error("edits must contain at least one edit");
-  const requiredFields = {
-    set_line: ["anchor", "new_text"],
-    replace_lines: ["end_anchor", "new_text", "start_anchor"],
-    insert_after: ["anchor", "new_text"],
-    replace: ["new_text", "old_text"],
-    replace_symbol: ["new_body", "symbol"]
-  };
-  for (const [index, item] of value.entries()) {
-    if (!item || typeof item !== "object")
-      throw new Error(`edits[${index}] must be an edit object`);
-    const keys = Object.keys(item);
-    const variant = keys[0];
-    if (keys.length !== 1 || !Object.hasOwn(requiredFields, variant)) {
-      throw new Error(`edits[${index}] must contain exactly one of: set_line, replace_lines, insert_after, replace, replace_symbol`);
-    }
-    const payload = item[variant];
-    if (!payload || typeof payload !== "object")
-      throw new Error(`edits[${index}].${variant} must be an object`);
-    const expectedFields = requiredFields[variant];
-    const allowedFields = variant === "replace" ? [...expectedFields, "all"] : expectedFields;
-    const actualFields = Object.keys(payload).sort();
-    if (actualFields.some((field) => !allowedFields.includes(field)) || expectedFields.some((field) => !actualFields.includes(field))) {
-      throw new Error(`edits[${index}].${variant} contains invalid fields`);
-    }
-    const values = payload;
-    for (const field of expectedFields) {
-      if (typeof values[field] !== "string") {
-        throw new Error(`edits[${index}].${variant}.${field} must be a string`);
-      }
-    }
-    if (variant === "replace" && values.all !== undefined && typeof values.all !== "boolean") {
-      throw new Error(`edits[${index}].replace.all must be a boolean`);
-    }
-    for (const field of expectedFields.filter((field2) => field2.endsWith("anchor"))) {
-      parseAnchor(values[field]);
-    }
-  }
+  const parsed = validateExactlyOneEditVariant(value);
+  if (!parsed.ok)
+    throw new Error(parsed.error);
 }
 function firstChangedLine(before, after) {
   const beforeLines = normalizeToLf(before).split(`
@@ -1373,10 +1470,6 @@ import path6 from "node:path";
 function resolvePath(directory, filePath) {
   return path6.resolve(directory, filePath);
 }
-function containsPath(directory, filePath) {
-  const relative = path6.relative(directory, filePath);
-  return relative === "" || !relative.startsWith(`..${path6.sep}`) && relative !== ".." && !path6.isAbsolute(relative);
-}
 async function resolveSymlinks(filePath) {
   let unresolved = path6.resolve(filePath);
   let symlinks = 0;
@@ -1439,7 +1532,7 @@ async function authorizeExternal(context, filePath) {
     canonicalPath(context.directory),
     context.worktree === "/" ? Promise.resolve("/") : canonicalPath(context.worktree)
   ]);
-  if (containsPath(directory, accessPath) || worktree !== "/" && containsPath(worktree, accessPath)) {
+  if (isSubPath(directory, accessPath) || worktree !== "/" && isSubPath(worktree, accessPath)) {
     return;
   }
   const info = await stat2(accessPath).catch(() => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-readseek",
-  "version": "0.9.13",
+  "version": "0.9.14",
   "description": "OpenCode plugin for anchored file operations and structural code navigation",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,8 +21,7 @@
   "license": "Apache-2.0",
   "files": [
     "dist/",
-    "README.md",
-    "LICENSE"
+    "README.md"
   ],
   "scripts": {
     "build": "bun build ./index.ts --outfile dist/index.js --target=node --format=esm --packages=external",
@@ -33,11 +32,11 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@jarkkojs/readseek": "^0.9.13",
+    "@jarkkojs/readseek": "^0.9.14",
     "@opencode-ai/plugin": "^1.17.20"
   },
   "devDependencies": {
     "@types/bun": "^1.3.14",
-    "typescript": "^7.0.2"
+    "typescript": "^5.9.3"
   }
 }

package/LICENSE

@@ -1,176 +0,0 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS