@ngis/plugin-sdk 0.4.0

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2026 NeoGIS contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,31 @@
+# @ngis/plugin-sdk
+
+The public, types-first authoring contract for NeoGIS map plugins.
+
+```bash
+npm install --save-dev @ngis/plugin-sdk
+```
+
+```ts
+import { defineNgisPlugin, type NgisPlugin } from "@ngis/plugin-sdk";
+
+const plugin: NgisPlugin = defineNgisPlugin({
+  manifest: {
+    id: "com.example.my-plugin",
+    name: "My plugin",
+    version: "0.1.0",
+    minNgisVersion: "0.4.0",
+    capabilities: {},
+  },
+});
+
+export default plugin;
+```
+
+Plugin builds must leave `@ngis/plugin-sdk` external. The running NeoGIS host
+provides the runtime through its plugin import map. The npm package supplies the
+real public declarations plus small host-delegating shims; bundling it into a
+plugin would create a runtime copy that is disconnected from the host.
+
+The package version matches `NGIS_MAP_API_VERSION`. Use
+`create-ngis-plugin` for a complete buildable starter.

package/dist/index.cjs

@@ -0,0 +1,76 @@
+// Generated by scripts/build.mjs from the real NGIS_MAP_API_VERSION (src/sdk/map-api.ts) —
+// do not hand-edit; the only runtime code this package ships (see src/index.ts's doc comment).
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const NGIS_EXTERNALS = "__NGIS_PLUGIN_EXTERNALS__";
+function hostValue(name) {
+  const sdk = globalThis[NGIS_EXTERNALS] && globalThis[NGIS_EXTERNALS]["@ngis/plugin-sdk"];
+  if (!sdk || sdk[name] === undefined) {
+    throw new Error(
+      "[ngis] @ngis/plugin-sdk." + name + " is host runtime: it is provided by the running NGIS " +
+      "frontend through globalThis." + NGIS_EXTERNALS + ". Leave \"@ngis/plugin-sdk\" external in your " +
+      "bundle (the host's import map resolves it) instead of bundling this file."
+    );
+  }
+  return sdk[name];
+}
+exports.NGIS_MAP_API_VERSION = "0.4.0";
+exports.defineNgisPlugin = function defineNgisPlugin(plugin) {
+  return plugin;
+};
+Object.defineProperty(exports, "reactPanel", {
+  enumerable: true,
+  get: () => hostValue("reactPanel"),
+});
+Object.defineProperty(exports, "contributedViewPanelId", {
+  enumerable: true,
+  get: () => hostValue("contributedViewPanelId"),
+});
+Object.defineProperty(exports, "CONTRIBUTED_VIEW_PANEL_PREFIX", {
+  enumerable: true,
+  get: () => hostValue("CONTRIBUTED_VIEW_PANEL_PREFIX"),
+});
+Object.defineProperty(exports, "compileWhenExpression", {
+  enumerable: true,
+  get: () => hostValue("compileWhenExpression"),
+});
+Object.defineProperty(exports, "NgisScopeError", {
+  enumerable: true,
+  get: () => hostValue("NgisScopeError"),
+});
+Object.defineProperty(exports, "NgisStorageError", {
+  enumerable: true,
+  get: () => hostValue("NgisStorageError"),
+});
+Object.defineProperty(exports, "NgisContextKeyError", {
+  enumerable: true,
+  get: () => hostValue("NgisContextKeyError"),
+});
+Object.defineProperty(exports, "NgisWhenSyntaxError", {
+  enumerable: true,
+  get: () => hostValue("NgisWhenSyntaxError"),
+});
+Object.defineProperty(exports, "NGIS_DATA_TYPES", {
+  enumerable: true,
+  get: () => hostValue("NGIS_DATA_TYPES"),
+});
+Object.defineProperty(exports, "NGIS_DATA_TYPE_TO_RESOURCE_TYPES", {
+  enumerable: true,
+  get: () => hostValue("NGIS_DATA_TYPE_TO_RESOURCE_TYPES"),
+});
+Object.defineProperty(exports, "NGIS_MAX_STATUS_ITEMS_PER_PLUGIN", {
+  enumerable: true,
+  get: () => hostValue("NGIS_MAX_STATUS_ITEMS_PER_PLUGIN"),
+});
+Object.defineProperty(exports, "NGIS_MAX_VISIBLE_STATUS_ITEMS", {
+  enumerable: true,
+  get: () => hostValue("NGIS_MAX_VISIBLE_STATUS_ITEMS"),
+});
+Object.defineProperty(exports, "NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT", {
+  enumerable: true,
+  get: () => hostValue("NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT"),
+});
+Object.defineProperty(exports, "NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN", {
+  enumerable: true,
+  get: () => hostValue("NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN"),
+});

package/dist/index.d.ts

@@ -0,0 +1,77 @@
+/**
+ * `@ngis/plugin-sdk` — the external DevKit distribution of the NGIS plugin
+ * contract (Stage 11 E3, `docs/design-extension-platform.md` §13, ED17;
+ * completed to **F14.13** by Stage 14 Y2).
+ *
+ * Types-first, on purpose: almost everything below is a `type` re-export
+ * straight off `ngis-frontend`'s real `src/sdk/` — the single source of truth
+ * an external plugin author compiles against — so version skew between this
+ * package and the running frontend stays a `minNgisVersion` negotiation problem
+ * (handled at runtime by `NgisPluginRuntime`), never a
+ * hand-copied-types-drifted-from-the-real-thing problem.
+ *
+ * ## The rule this file obeys (F14.13, closing `V-116`)
+ *
+ * **Every type name reachable from `NgisHostAPI`'s declaration graph is
+ * re-exported here.** Before Stage 14 it published the 0.3 map facade, the
+ * panel types and the plugin/manifest types and *none* of the 0.4 facet type
+ * names, so all three dogfood packages carried a `src/host-types.ts` that
+ * recovered `NgisTaskState` and friends structurally
+ * (`Awaited<ReturnType<Host["tasks"]["list"]>>[number]`) — reachable by the
+ * compiler, unnameable by the author. Those three files are deleted; this list
+ * is what replaced them.
+ *
+ * Two names are deliberately **not** here and neither is an oversight:
+ * `MapLibreMap` (`getMap()`'s return) belongs to `maplibre-gl`, which an author
+ * imports directly, and the `NgisValidate*Body` / `NgisToolSearch*` wire DTOs
+ * are the server's REST shapes, not reachable from any facet signature.
+ *
+ * ## The exported *values* are a closed list (F14.13)
+ *
+ * Fifteen names, and adding a sixteenth is a contract amendment. Values are the
+ * risky half — they are what a bundle actually links against — so they are also
+ * exactly what `installPluginExternals()` and
+ * `public/plugin-externals/plugin-sdk.mjs` must carry, and those three lists
+ * move together or a plugin fails at link time in the browser having compiled
+ * clean.
+ *
+ * `NGIS_SCOPE_MEMBERS` and `NGIS_UNGATED_MEMBERS` stay **host-internal**: they
+ * are the enforcement table a plugin is judged against, not an authoring
+ * surface, and publishing them invites them to be read as permission.
+ *
+ * ## Versions are locked, not aligned (F14.13, closing `V-162`)
+ *
+ * ```
+ * @ngis/plugin-sdk version === @ngis/plugin-ui version === NGIS_MAP_API_VERSION === "0.4.0"
+ * ```
+ *
+ * One string. The types below are traced from the live program, so any
+ * divergence is a lie about what the tarball contains.
+ *
+ * This file is NOT built by `tsc`/bundled directly into the published
+ * package — `scripts/build.mjs` type-checks it (and its transitive closure)
+ * against the real frontend program, then flattens the emitted declarations
+ * into `dist/`. Do not hand-copy any type below; add a re-export line here
+ * and let the build trace it.
+ */
+export { NGIS_MAP_API_VERSION, type NgisMapAPI, type NgisMapAPIBindings, type NgisLayersFacet, type NgisCameraFacet, type NgisSelectionFacet, type NgisHighlightFacet, type NgisDrawFacet, type NgisMeasureFacet, type NgisEventsFacet, type NgisLayerSummary, type NgisMapView, type NgisBounds, type NgisHighlight, type NgisMapEventName, type NgisUnsubscribe, } from "./src/sdk/map-api";
+export { reactPanel, type WorkspacePanelRegistry, type PanelSlot, type PanelRegistration, type PanelRenderFn, type PanelRenderContext, type PanelDisposer, type ReactPanelRenderFn, } from "./src/sdk/panels";
+export { type LayerRendererEntry, type LayerRenderContext, type SceneLayerRenderInput, } from "./src/systems/renderer/LayerRendererRegistry";
+export { type GisDynamicToolDef, } from "./src/sdk/rail-tools";
+export { type GisRailInvokeContext, type GisRailApi, type GisRailStoreHandle, type GisRailPanelControl, type GisDrawMode, type GisMeasureKind, } from "./src/types/gis";
+export { type CommandInvokeContext, type CommandRegistration, } from "./src/sdk/commands";
+export { type NgisPlugin, type NgisPluginCapabilities, type NgisPluginDisposer, type NgisPluginHost, type NgisPluginManifest, } from "./src/sdk/plugin";
+export { type NgisHostAPI, type NgisVizFacet, type NgisChartKind, type NgisChartSeries, type NgisChartSpec, type NgisStorageFacet, type NgisStorageLeg, type NgisStorageWriteFailure, type NgisHostContextFacet, type NgisHostContextValue, type NgisUiFacet, type NgisQuickPickItem, type NgisProgressHandle, type NgisCommandsFacet, type NgisCommandSummary, } from "./src/sdk/host-api";
+export { NGIS_DATA_TYPES, NGIS_DATA_TYPE_TO_RESOURCE_TYPES, type NgisDataType, type NgisSceneFacet, type NgisSceneInfo, type NgisResourcesFacet, type NgisResourceSummary, type NgisResourceDetail, type NgisResourceField, type NgisResourceType, type NgisModelsFacet, type NgisModelSummary, type NgisModelboxNode, type NgisModelSchema, type NgisModelValidateRequest, type NgisModelSearchRequest, type NgisModelSearchResult, type NgisTasksFacet, type NgisTaskRunRequest, type NgisTaskHandle, type NgisTaskState, type NgisTaskStatus, type NgisTaskStage, type NgisTaskOutput, type NgisTaskWatcher, } from "./src/sdk/facets/types";
+/** `NgisSceneInfo.type`. Declared in the app's scene client, reachable from the
+ *  facade, and therefore nameable here — the whole point of the F14.13 rule. */
+export { type SceneType } from "./src/api/scenes";
+export { type NgisToolUiSchema, type NgisToolUiParam, type NgisUiSchemaChoice, type NgisUiSchemaDependency, type NgisUiSchemaValueType, type NgisWidgetKey, type NgisParamRole, type NgisExecutionValidation, type NgisExecutionVerdict, type NgisExecutionMode, type NgisOutputMode, type NgisBindingValidation, type NgisBindingValidationEntry, type NgisBindingVerdict, type NgisDatasetBindingWire, } from "./src/types/analysis";
+export { NGIS_MAX_STATUS_ITEMS_PER_PLUGIN, NGIS_MAX_VISIBLE_STATUS_ITEMS, NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT, NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN, type NgisContributes, type NgisActivationEvent, type NgisGatedContribution, type NgisMenuContributions, type NgisMenuGroup, type NgisMenuItemContribution, type NgisMenuSlot, type NgisPermissionScope, type NgisSettingsContribution, type NgisSettingsProperty, type NgisSettingsPropertyType, type NgisSettingsScope, type NgisStatusItemContribution, type NgisSymbolRendererContribution, type NgisSymbolRendererGeometry, type NgisSymbolRendererParam, type NgisSymbolRendererParamType, type NgisSymbolRendererSlot, type NgisToolContribution, type NgisToolPreset, type NgisViewContribution, type NgisViewSlot, } from "./src/sdk/contributions/types";
+export type { NgisSymbolLayerDescriptor, NgisSymbolRenderContext, NgisSymbolRendererFn, NgisSymbolRendererModule, } from "./src/sdk/contributions/symbol-renderers";
+export { CONTRIBUTED_VIEW_PANEL_PREFIX, contributedViewPanelId, } from "./src/sdk/contributions/views-bridge";
+export { NgisWhenSyntaxError, compileWhenExpression, type CompiledWhenExpression, type ContextReader, } from "./src/sdk/context/when";
+export { NgisContextKeyError, type NgisContextValue, } from "./src/sdk/context/keys";
+export { NgisScopeError } from "./src/sdk/scopes";
+export { NgisStorageError } from "./src/sdk/facets/storage";
+export { defineNgisPlugin } from "./src/sdk/define-plugin";

package/dist/index.mjs

@@ -0,0 +1,102 @@
+// Generated by scripts/build.mjs from the real NGIS_MAP_API_VERSION (src/sdk/map-api.ts) —
+// do not hand-edit; the only runtime code this package ships (see src/index.ts's doc comment).
+const NGIS_EXTERNALS = "__NGIS_PLUGIN_EXTERNALS__";
+function hostValue(name) {
+  const sdk = globalThis[NGIS_EXTERNALS] && globalThis[NGIS_EXTERNALS]["@ngis/plugin-sdk"];
+  if (!sdk || sdk[name] === undefined) {
+    throw new Error(
+      "[ngis] @ngis/plugin-sdk." + name + " is host runtime: it is provided by the running NGIS " +
+      "frontend through globalThis." + NGIS_EXTERNALS + ". Leave \"@ngis/plugin-sdk\" external in your " +
+      "bundle (the host's import map resolves it) instead of bundling this file."
+    );
+  }
+  return sdk[name];
+}
+export const NGIS_MAP_API_VERSION = "0.4.0";
+export function defineNgisPlugin(plugin) {
+  return plugin;
+}
+export const reactPanel = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("reactPanel"), key),
+  has: (_t, key) => Reflect.has(hostValue("reactPanel"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("reactPanel"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("reactPanel"), args),
+});
+export const contributedViewPanelId = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("contributedViewPanelId"), key),
+  has: (_t, key) => Reflect.has(hostValue("contributedViewPanelId"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("contributedViewPanelId"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("contributedViewPanelId"), args),
+});
+export const CONTRIBUTED_VIEW_PANEL_PREFIX = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("CONTRIBUTED_VIEW_PANEL_PREFIX"), key),
+  has: (_t, key) => Reflect.has(hostValue("CONTRIBUTED_VIEW_PANEL_PREFIX"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("CONTRIBUTED_VIEW_PANEL_PREFIX"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("CONTRIBUTED_VIEW_PANEL_PREFIX"), args),
+});
+export const compileWhenExpression = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("compileWhenExpression"), key),
+  has: (_t, key) => Reflect.has(hostValue("compileWhenExpression"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("compileWhenExpression"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("compileWhenExpression"), args),
+});
+export const NgisScopeError = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NgisScopeError"), key),
+  has: (_t, key) => Reflect.has(hostValue("NgisScopeError"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NgisScopeError"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NgisScopeError"), args),
+});
+export const NgisStorageError = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NgisStorageError"), key),
+  has: (_t, key) => Reflect.has(hostValue("NgisStorageError"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NgisStorageError"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NgisStorageError"), args),
+});
+export const NgisContextKeyError = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NgisContextKeyError"), key),
+  has: (_t, key) => Reflect.has(hostValue("NgisContextKeyError"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NgisContextKeyError"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NgisContextKeyError"), args),
+});
+export const NgisWhenSyntaxError = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NgisWhenSyntaxError"), key),
+  has: (_t, key) => Reflect.has(hostValue("NgisWhenSyntaxError"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NgisWhenSyntaxError"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NgisWhenSyntaxError"), args),
+});
+export const NGIS_DATA_TYPES = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NGIS_DATA_TYPES"), key),
+  has: (_t, key) => Reflect.has(hostValue("NGIS_DATA_TYPES"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NGIS_DATA_TYPES"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NGIS_DATA_TYPES"), args),
+});
+export const NGIS_DATA_TYPE_TO_RESOURCE_TYPES = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NGIS_DATA_TYPE_TO_RESOURCE_TYPES"), key),
+  has: (_t, key) => Reflect.has(hostValue("NGIS_DATA_TYPE_TO_RESOURCE_TYPES"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NGIS_DATA_TYPE_TO_RESOURCE_TYPES"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NGIS_DATA_TYPE_TO_RESOURCE_TYPES"), args),
+});
+export const NGIS_MAX_STATUS_ITEMS_PER_PLUGIN = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NGIS_MAX_STATUS_ITEMS_PER_PLUGIN"), key),
+  has: (_t, key) => Reflect.has(hostValue("NGIS_MAX_STATUS_ITEMS_PER_PLUGIN"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NGIS_MAX_STATUS_ITEMS_PER_PLUGIN"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NGIS_MAX_STATUS_ITEMS_PER_PLUGIN"), args),
+});
+export const NGIS_MAX_VISIBLE_STATUS_ITEMS = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NGIS_MAX_VISIBLE_STATUS_ITEMS"), key),
+  has: (_t, key) => Reflect.has(hostValue("NGIS_MAX_VISIBLE_STATUS_ITEMS"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NGIS_MAX_VISIBLE_STATUS_ITEMS"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NGIS_MAX_VISIBLE_STATUS_ITEMS"), args),
+});
+export const NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT"), key),
+  has: (_t, key) => Reflect.has(hostValue("NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NGIS_MAX_MENU_ITEMS_PER_PLUGIN_PER_SLOT"), args),
+});
+export const NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN = /* @__PURE__ */ new Proxy(function () {}, {
+  get: (_t, key) => Reflect.get(hostValue("NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN"), key),
+  has: (_t, key) => Reflect.has(hostValue("NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN"), key),
+  apply: (_t, self, args) => Reflect.apply(hostValue("NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN"), self, args),
+  construct: (_t, args) => Reflect.construct(hostValue("NGIS_MAX_SYMBOL_RENDERERS_PER_PLUGIN"), args),
+});

package/dist/src/api/analysis.d.ts

@@ -0,0 +1,140 @@
+import type { NgisBindingValidation, NgisExecutionValidation, NgisToolSearchResponse, NgisToolUiSchema, NgisValidateBindingsBody, NgisValidateExecutionBody } from "../types/analysis";
+import type { PageResult } from "../types/common";
+export interface AnalysisModelboxNode {
+    id: string;
+    name: string;
+    provider?: string | null;
+    parent_id?: string | null;
+    children?: AnalysisModelboxNode[] | null;
+}
+export interface AnalysisTool {
+    id: string;
+    version?: number | null;
+    name: string;
+    provider?: string | null;
+    category?: string | null;
+    description?: string | null;
+    tags?: string[] | string | null;
+    enabled?: boolean | null;
+    modelbox_id?: string | null;
+    capability_key?: string | null;
+}
+export interface AnalysisToolSchemaProperty {
+    title?: string | null;
+    description?: string | null;
+    type?: string | string[] | null;
+    format?: string | null;
+    enum?: unknown[] | null;
+    default?: string | number | boolean | null;
+    default_val?: string | number | boolean | null;
+    minimum?: number | null;
+    maximum?: number | null;
+    "x-role"?: "input" | "output" | "option" | string | null;
+    "x-data-type"?: "Vector" | "Raster" | "Table" | string | null;
+    "x-display-name"?: string | null;
+    "x-constraints"?: {
+        min?: number | null;
+        max?: number | null;
+        choices?: unknown[] | null;
+        [key: string]: unknown;
+    } | null;
+    choices?: unknown[] | null;
+    items?: AnalysisToolSchemaProperty | null;
+    "x-ngis-type"?: string | null;
+    "x-ngis-role"?: string | null;
+    [key: string]: unknown;
+}
+export interface AnalysisToolSchema extends AnalysisToolSchemaProperty {
+    properties?: Record<string, AnalysisToolSchemaProperty> | null;
+    required?: string[] | null;
+}
+export type AnalysisTaskStatus = "QUEUED" | "RUNNING" | "SUCCESS" | "FAILED" | "CANCELLED";
+export type AnalysisTaskOutputMode = "ADD_LAYER" | "UPDATE_RESOURCE";
+export interface CreateAnalysisTaskParams {
+    tool_id: string;
+    params: Record<string, string>;
+    scene_id?: string;
+    expected_scene_generation?: number;
+    output_mode?: AnalysisTaskOutputMode;
+    target_resource_id?: string;
+}
+export interface AnalysisTask {
+    id: string;
+    tool_id: string;
+    provider?: string | null;
+    status: AnalysisTaskStatus;
+    params_json?: unknown;
+    output_json?: unknown;
+    error_message?: string | null;
+    log_output?: string | null;
+    exit_code?: number | null;
+    owner_id?: string | null;
+    scene_id?: string | null;
+    expected_scene_generation?: number | null;
+    integration_status?: "PENDING" | "DONE" | "PARTIAL" | "FAILED" | "SKIPPED" | null;
+    integration_detail?: string | null;
+}
+export interface AnalysisTaskOutputFile {
+    name?: string | null;
+    minio_key?: string | null;
+    file_id?: string | null;
+    primary?: boolean | null;
+}
+export declare const analysisApi: {
+    listModelboxes(): Promise<AnalysisModelboxNode[]>;
+    listTools(params?: {
+        provider?: string;
+        category?: string;
+        capability_key?: string;
+        modelbox_id?: string;
+        recursive?: boolean;
+    }, signal?: AbortSignal): Promise<AnalysisTool[]>;
+    listModelboxTools(boxId: string, recursive?: boolean): Promise<AnalysisTool[]>;
+    /**
+     * Paged sibling of `listTools`, for browsing the ~2,300-tool catalog (`/models`).
+     *
+     * `q` is a server-side substring match over name/description/category/tags. The
+     * envelope is the platform-wide `PageResult<T>` shape; the rows are the same
+     * snake_case `AnalysisTool` the flat list returns.
+     */
+    pageTools(params?: {
+        page?: number;
+        size?: number;
+        q?: string;
+        provider?: string;
+        category?: string;
+        capability_key?: string;
+        modelbox_id?: string;
+        recursive?: boolean;
+    }, signal?: AbortSignal): Promise<PageResult<AnalysisTool>>;
+    getTool(toolId: string, signal?: AbortSignal): Promise<AnalysisTool>;
+    getToolSchema(toolId: string, signal?: AbortSignal): Promise<AnalysisToolSchema>;
+    createTask(params: CreateAnalysisTaskParams, signal?: AbortSignal): Promise<AnalysisTask>;
+    getTask(taskId: string, signal?: AbortSignal): Promise<AnalysisTask>;
+    getTaskOutputFiles(taskId: string, signal?: AbortSignal): Promise<AnalysisTaskOutputFile[]>;
+    cancelTask(taskId: string, signal?: AbortSignal): Promise<void>;
+    streamTask(taskId: string, signal?: AbortSignal): Promise<Response>;
+    getToolUiSchema(toolId: string, signal?: AbortSignal): Promise<NgisToolUiSchema>;
+    validateToolExecution(toolId: string, body: NgisValidateExecutionBody, signal?: AbortSignal): Promise<NgisExecutionValidation>;
+    validateToolBindings(toolId: string, body: NgisValidateBindingsBody, signal?: AbortSignal): Promise<NgisBindingValidation>;
+    searchTools(params?: AnalysisToolSearchParams, signal?: AbortSignal): Promise<NgisToolSearchResponse>;
+};
+/** Repeated-value filters, named exactly as the server's `Query` params. */
+export interface AnalysisToolSearchParams {
+    q?: string;
+    limit?: number;
+    provider?: readonly string[];
+    kind?: readonly string[];
+    input_type?: readonly string[];
+    output_type?: readonly string[];
+    domain?: readonly string[];
+    operation_type?: readonly string[];
+    modelbox_path?: readonly string[];
+    capability_key?: readonly string[];
+}
+/**
+ * Exported for test: the repeated-parameter shape is the whole point of this
+ * helper, and asserting it on a built string is cheaper than asserting it on a
+ * captured fetch URL.
+ */
+export declare function buildToolSearchQuery(params: AnalysisToolSearchParams): string;