@jawji/orchestrator 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 utachicodes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,181 @@
+# jawji-orchestrator
+
+[![npm version](https://img.shields.io/npm/v/%40jawji%2Forchestrator.svg)](https://www.npmjs.com/package/@jawji/orchestrator)
+[![CI](https://github.com/utachicodes/jawji-orchestrator/actions/workflows/ci.yml/badge.svg)](https://github.com/utachicodes/jawji-orchestrator/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+Standalone onboard vision assisted autonomy for a companion computer, starting with a landing zone safety check.
+
+## What this is
+
+This package runs on a companion computer (a Jetson or Raspberry Pi, for example), as its own process, with its own direct connection to the flight controller through a local `mavsdk_server`. It watches vehicle telemetry, and when a configured mode is triggered (the landing zone check triggers on entering LAND mode), it holds the vehicle, captures a camera frame, sends that frame to a vision language model, and decides whether the current position looks safe.
+
+## What this is not
+
+This is not a ground control station feature, and it does not require a ground control station to be connected. It has no dependency on any particular GCS. A GCS, or any other operator interface, can observe and confirm what this package is doing by talking to its local HTTP API, but that is entirely optional and the package works correctly with nothing else connected at all.
+
+This package also does not include a vision language model server, and does not include camera capture code for any specific hardware. Both are supplied by the integrator through the adapter interfaces described below.
+
+## How the pieces fit together
+
+1. `mavsdk_server` runs on the companion computer, exposing MAVSDK's gRPC interface against the flight controller connection.
+2. This package connects to that `mavsdk_server` over gRPC, using vendored proto definitions from the official `mavlink/MAVSDK-Proto` repository, loaded at runtime with `@grpc/proto-loader`. There is no official MAVSDK Node.js client published to npm, which is why this package generates its own client rather than depending on one.
+3. When the vehicle's flight mode telemetry reports LAND, the orchestrator commands a hold through the MAVSDK action service, then asks the integrator supplied `CameraSource` for a frame.
+4. That frame, along with a prompt, is sent to the integrator supplied `VlmClient`. This package does not care which vision language model answers, only that the response includes a `status` field (`safe` or `unsafe`) and, when unsafe, an optional candidate location.
+5. If the verdict is safe, the vehicle resumes its mission automatically.
+6. If the verdict is unsafe or the vision language model call failed, the orchestrator holds and exposes the verdict on a small local HTTP server, bound to 127.0.0.1 only, by default on port 48500.
+7. Something else, a GCS, a remote control channel, anything with network access to that local API, posts a confirm or reject decision to `/confirm`. The orchestrator then either repositions to the candidate and re-evaluates, or resumes the original landing.
+8. Step 7 repeats up to three times if repositioning to a candidate still does not come back safe. After three attempts the orchestrator reports a no safe alternative found status and holds indefinitely rather than continuing to reposition on its own.
+9. If nothing responds to a confirm request at all, the vehicle simply continues holding. This package does not invent a timeout based fallback action. The flight controller's own existing failsafes, such as battery or radio control loss, remain the safety net if the vehicle is genuinely unattended.
+
+## Architecture
+
+```
+                    +---------------------------+
+                    |   Companion computer       |
+                    |   (Jetson, Raspberry Pi)   |
+                    |                             |
+  Flight  <--gRPC-->|  mavsdk_server              |
+  controller        |        ^                    |
+                    |        | gRPC (vendored      |
+                    |        |  MAVSDK-Proto)      |
+                    |        v                    |
+                    |  jawji-orchestrator          |
+                    |   |  VisionAssistMode(s)     |
+                    |   |   - LandingZoneCheckMode |
+                    |   |  VehicleAdapter          |
+                    |   |  CameraSource (yours)    |
+                    |   |  VlmClient (yours)       |
+                    |   |  local status/confirm    |
+                    |   |  HTTP API (127.0.0.1)    |
+                    +---------------------------+
+                              ^
+                              | HTTP, localhost only
+                              | (you decide what, if
+                              |  anything, reaches this)
+                    +---------------------------+
+                    | Optional: a GCS, a relay,  |
+                    | jawji-agent, an SSH tunnel |
+                    +---------------------------+
+```
+
+The only two hard dependencies are `mavsdk_server` (for vehicle control and telemetry) and an HTTP endpoint implementing `VlmClient` (for scene assessment). Everything above the local HTTP API line is optional and this package has no awareness of what, if anything, is there.
+
+### Relationship with Jawji Agent
+
+None, currently. This is worth stating plainly since jawji-orchestrator and [Jawji Agent](https://github.com/utachicodes/jawjideck/tree/master/packages/jawji-agent) get mentioned together often enough that it would be easy to assume they are connected. They are two separate, independently running pieces of software. If you deploy both on the same companion computer today, they run side by side, each unaware the other exists.
+
+The intended integration, not yet built, is for Jawji Agent to poll this package's local `/status` endpoint and relay `/confirm` decisions through its own existing authenticated REST API, the same pattern it already uses to expose MediaMTX's local status to a connected Jawji desktop app. Until that exists, anything that wants to observe or confirm what jawji-orchestrator is doing needs to reach its local HTTP API some other way, for example an SSH tunnel, or a small relay process you write yourself.
+
+### Miril-Drone-2B-1 support
+
+[`createMirilVlmClient`](src/vlm/miril-client.ts) is a built-in `VlmClient` implementation for [Miril-Drone-2B-1](https://huggingface.co/MirilAI/Miril-Drone-2B-1), a vision language model fine-tuned for aerial imagery, with response shapes for scene captioning, visual question answering, and operational coordinate pointing (the `operational_coordinate_v2` family used by `LandingZoneCheckMode`).
+
+Miril has no single canonical HTTP protocol of its own. This client targets the OpenAI-compatible `/v1/chat/completions` shape instead, because that is what every realistic way of serving Miril implements for multimodal chat: `llama-server` from `llama.cpp`, vLLM, and SGLang all speak it. The image is sent as a base64 data URL in an `image_url` content part, alongside a text instruction built from the requested prompt family plus whatever prompt the calling mode supplies.
+
+```typescript
+import { createOrchestrator, createMirilVlmClient, createLandingZoneCheckMode } from '@jawji/orchestrator';
+
+const orchestrator = createOrchestrator({
+  mavsdkServerAddress: 'localhost:50051',
+  vlmClient: createMirilVlmClient({
+    endpoint: 'http://127.0.0.1:8000/v1/chat/completions', // llama-server, vLLM, or SGLang
+    promptFamily: 'operational_coordinate_v2',
+  }),
+  cameraSource: { async captureFrame() { /* ... */ throw new Error('not implemented'); } },
+  confirmPolicy: 'gated',
+  statusServerPort: 48500,
+  modes: [createLandingZoneCheckMode()],
+});
+```
+
+This does not ship a Miril server. You still need to stand one up yourself, for example `llama-server` running a GGUF quantization of Miril-Drone-2B-1 on the companion computer, and point `endpoint` at it. `createHttpVlmClient` remains available as the plain, protocol-agnostic option for any other vision language model, or any custom HTTP shape you prefer.
+
+### GPS-denied navigation (research, not implemented)
+
+This was asked about directly, so it deserves an honest answer rather than either dismissing it or bolting on unreviewed code that would push position estimates into a real flight controller. There is no landmark memory or GPS-denied mode in this package today. Below is the concrete design it would take, written down so it can be reviewed and built deliberately rather than shipped without scrutiny, given that it touches the flight controller's position estimate.
+
+**Why this is a different kind of problem than landing-zone-check.** `LandingZoneCheckMode` is a single-shot check: one frame in, one verdict out, no memory across time. Landmark-based re-localization needs the opposite: persistent state built up over the whole flight, a way to match a new frame against everything remembered so far, and a way to feed a corrected position back into the flight controller.
+
+**The three pieces, and what already exists to support each of them:**
+
+1. **Recording landmarks while GPS is healthy.** MAVSDK's telemetry service has `SubscribeHealth`, which includes an `is_global_position_ok` field, confirmed directly against the real `telemetry.proto`. A recording step would run on a timer or distance interval while that flag is true, capturing a frame plus the current position and storing them.
+
+2. **Matching a new frame against stored landmarks when GPS is lost.** A captioning vision language model like Miril is the wrong tool for this specific step. It is built to describe a scene in words, not to produce a precise, viewpoint-stable embedding for place recognition, and comparing generated captions is a poor substitute for comparing actual visual features. The realistic options, roughly in order of how much they would add to this package's current no-native-addon design goal:
+   - **Perceptual image hashing** (average hash or difference hash) as a coarse, cheap first pass. Genuinely implementable in pure JavaScript with a library like `jimp` (no native addon, same constraint this package already holds itself to for `@grpc/grpc-js`), but only catches near-duplicate viewpoints, not real viewpoint-invariant matching. Honest baseline, not real visual place recognition.
+   - **A dedicated visual place recognition embedding model** (for example NetVLAD-style or a ViT-based place recognition model) run locally via an ONNX runtime, with nearest-neighbor search over stored embeddings. Meaningfully more reliable, but reintroduces a native-or-WASM ML runtime dependency this package has otherwise avoided, and needs a specific model choice and real accuracy validation against actual flight footage before it could be trusted.
+   - **Classical feature matching** (ORB or SIFT keypoints via OpenCV) as the well-established SLAM/relocalization approach, at the cost of an OpenCV dependency, which is a native addon on most platforms.
+
+3. **Feeding a match back to the flight controller.** MAVSDK's `mocap` service exists for exactly this: `MocapService.SetVisionPositionEstimate`, confirmed directly against the real `mocap.proto`, takes a body-frame position estimate (`PositionBody`: x/y/z in metres, not raw latitude/longitude) intended for exactly the case the proto's own comment describes, "navigation without global positioning sources available (e.g. indoors, or when flying under a bridge)." A landmark match would need converting from a stored global position plus the current relative offset into that body-frame form before calling it.
+
+None of this is built. Given it would be capable of altering the flight controller's position estimate, and the accuracy of any of the matching approaches above needs validating against real flight footage before being trusted, the honest recommendation is to design and review this as its own effort, following the same pattern this package's own `LandingZoneCheckMode` did: a design document, an explicit confirm-gate default, and real testing before anything resembling autonomous behavior.
+
+## Confirm gate policy
+
+By default, `confirmPolicy` is `gated`, meaning an unsafe or unknown verdict always blocks on step 7 above until an external confirm arrives. Setting `confirmPolicy` to `autonomous` skips that wait entirely and acts on the mode's own default decision immediately. This must be set explicitly. The default is `gated` on purpose, so that using this package does not silently grant a companion computer the ability to make unattended repositioning decisions unless that is a deliberate choice by whoever is integrating it.
+
+## Local HTTP API
+
+Bound to `127.0.0.1` only, not exposed to the network by this package. Default port 48500.
+
+`GET /status` returns the current orchestrator status as JSON, one of:
+
+```json
+{ "state": "idle" }
+{ "state": "holding" }
+{ "state": "awaiting-confirm", "verdict": { "status": "unsafe", "candidate": { "latitudeDeg": 1.23, "longitudeDeg": 4.56, "description": "clearer patch to the north east" } } }
+{ "state": "no-safe-alternative" }
+```
+
+`POST /confirm` accepts a JSON body of either:
+
+```json
+{ "action": "accept-candidate" }
+{ "action": "reject" }
+```
+
+Anything with network reachability to the companion computer's localhost, such as a reverse proxy, an agent process, or an SSH tunnel, can be layered in front of this API to expose it more broadly. This package deliberately does not do that itself, since deciding who is allowed to confirm a landing decision is a security and trust boundary question for the integrator, not something this package should assume an answer to.
+
+## Usage
+
+```typescript
+import {
+  createOrchestrator,
+  createHttpVlmClient,
+  createLandingZoneCheckMode,
+} from '@jawji/orchestrator';
+
+const orchestrator = createOrchestrator({
+  mavsdkServerAddress: 'localhost:50051',
+  vlmClient: createHttpVlmClient('http://127.0.0.1:8000/query'),
+  cameraSource: {
+    async captureFrame() {
+      // Return the current frame as a JPEG or PNG Buffer, from whatever
+      // camera source is available on this companion computer.
+      throw new Error('not implemented');
+    },
+  },
+  confirmPolicy: 'gated',
+  statusServerPort: 48500,
+  modes: [createLandingZoneCheckMode()],
+});
+
+await orchestrator.start();
+```
+
+## Prerequisites
+
+- A running `mavsdk_server` connected to the flight controller.
+- A vision language model reachable over HTTP that accepts an image and a prompt and returns JSON with at least a `status` field. This package does not ship one. A small local server such as `llama-server` from `llama.cpp`, or a hosted endpoint, both work equally well as long as the response shape matches.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## License
+
+MIT, see [LICENSE](LICENSE).

package/dist/adapters/mavsdk-adapter.d.ts

@@ -0,0 +1,4 @@
+import type { MavsdkClients } from '../grpc/mavsdk-client.js';
+import type { VehicleAdapter } from '../types.js';
+export declare function createMavsdkVehicleAdapter(clients: MavsdkClients): VehicleAdapter;
+//# sourceMappingURL=mavsdk-adapter.d.ts.map

package/dist/adapters/mavsdk-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mavsdk-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/mavsdk-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAgB,MAAM,aAAa,CAAC;AAwBhE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAsCjF"}

package/dist/adapters/mavsdk-adapter.js

@@ -0,0 +1,51 @@
+function callUnary(method, request) {
+    return new Promise((resolve, reject) => {
+        method(request, (err, response) => {
+            if (err)
+                reject(err);
+            else
+                resolve(response);
+        });
+    });
+}
+const FLIGHT_MODE_MAP = {
+    FLIGHT_MODE_READY: 'READY',
+    FLIGHT_MODE_TAKEOFF: 'TAKEOFF',
+    FLIGHT_MODE_HOLD: 'HOLD',
+    FLIGHT_MODE_MISSION: 'MISSION',
+    FLIGHT_MODE_RETURN_TO_LAUNCH: 'RETURN_TO_LAUNCH',
+    FLIGHT_MODE_LAND: 'LAND',
+    FLIGHT_MODE_OFFBOARD: 'OFFBOARD',
+};
+export function createMavsdkVehicleAdapter(clients) {
+    return {
+        async hold() {
+            await callUnary(clients.action.hold.bind(clients.action), {});
+        },
+        async gotoLocation(coords) {
+            await callUnary(clients.action.gotoLocation.bind(clients.action), {
+                latitudeDeg: coords.latitudeDeg,
+                longitudeDeg: coords.longitudeDeg,
+                absoluteAltitudeM: coords.absoluteAltitudeM,
+                yawDeg: 0,
+            });
+        },
+        async resumeMission() {
+            await callUnary(clients.mission.startMission.bind(clients.mission), {});
+        },
+        subscribeFlightMode(onChange) {
+            const call = clients.telemetry.subscribeFlightMode({});
+            call.on('data', (response) => {
+                const mode = response.flightMode ?? 'FLIGHT_MODE_UNKNOWN';
+                onChange({
+                    flightMode: FLIGHT_MODE_MAP[mode] ?? 'OTHER',
+                    latitudeDeg: 0,
+                    longitudeDeg: 0,
+                    absoluteAltitudeM: 0,
+                });
+            });
+            return () => call.cancel();
+        },
+    };
+}
+//# sourceMappingURL=mavsdk-adapter.js.map

package/dist/adapters/mavsdk-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mavsdk-adapter.js","sourceRoot":"","sources":["../../src/adapters/mavsdk-adapter.ts"],"names":[],"mappings":"AAGA,SAAS,SAAS,CAChB,MAA8F,EAC9F,OAAgB;IAEhB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE;YAChC,IAAI,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,CAAC;;gBAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,eAAe,GAA+C;IAClE,iBAAiB,EAAE,OAAO;IAC1B,mBAAmB,EAAE,SAAS;IAC9B,gBAAgB,EAAE,MAAM;IACxB,mBAAmB,EAAE,SAAS;IAC9B,4BAA4B,EAAE,kBAAkB;IAChD,gBAAgB,EAAE,MAAM;IACxB,oBAAoB,EAAE,UAAU;CACjC,CAAC;AAEF,MAAM,UAAU,0BAA0B,CAAC,OAAsB;IAC/D,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAU,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,KAAK,CAAC,YAAY,CAAC,MAAM;YACvB,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAU,EAAE;gBACzE,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;gBAC3C,MAAM,EAAE,CAAC;aACV,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,aAAa;YACjB,MAAM,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAU,EAAE,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,mBAAmB,CAAC,QAAQ;YAC1B,MAAM,IAAI,GAAI,OAAO,CAAC,SAAS,CAAC,mBAG9B,CAAC,EAAE,CAAC,CAAC;YAEP,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,QAAiB,EAAE,EAAE;gBACpC,MAAM,IAAI,GAAI,QAAoC,CAAC,UAAU,IAAI,qBAAqB,CAAC;gBACvF,QAAQ,CAAC;oBACP,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,OAAO;oBAC5C,WAAW,EAAE,CAAC;oBACd,YAAY,EAAE,CAAC;oBACf,iBAAiB,EAAE,CAAC;iBACrB,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/vlm-client.d.ts

@@ -0,0 +1,3 @@
+import type { VlmClient } from '../types.js';
+export declare function createHttpVlmClient(endpoint: string): VlmClient;
+//# sourceMappingURL=vlm-client.d.ts.map

package/dist/adapters/vlm-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vlm-client.d.ts","sourceRoot":"","sources":["../../src/adapters/vlm-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAmB/D"}

package/dist/adapters/vlm-client.js

@@ -0,0 +1,19 @@
+export function createHttpVlmClient(endpoint) {
+    return {
+        async query(image, prompt) {
+            const response = await fetch(endpoint, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    imageBase64: image.toString('base64'),
+                    prompt,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`VLM query failed with status ${response.status}`);
+            }
+            return response.json();
+        },
+    };
+}
+//# sourceMappingURL=vlm-client.js.map

package/dist/adapters/vlm-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vlm-client.js","sourceRoot":"","sources":["../../src/adapters/vlm-client.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAClD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,MAAc;YACvC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;gBACrC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;oBACrC,MAAM;iBACP,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACrE,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/grpc/mavsdk-client.d.ts

@@ -0,0 +1,8 @@
+import * as grpc from '@grpc/grpc-js';
+export interface MavsdkClients {
+    action: grpc.Client & Record<string, (...args: unknown[]) => unknown>;
+    telemetry: grpc.Client & Record<string, (...args: unknown[]) => unknown>;
+    mission: grpc.Client & Record<string, (...args: unknown[]) => unknown>;
+}
+export declare function loadMavsdkClients(serverAddress: string): MavsdkClients;
+//# sourceMappingURL=mavsdk-client.d.ts.map

package/dist/grpc/mavsdk-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mavsdk-client.d.ts","sourceRoot":"","sources":["../../src/grpc/mavsdk-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AA4BtC,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACtE,SAAS,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACzE,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;CACxE;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,CAkBtE"}

package/dist/grpc/mavsdk-client.js

@@ -0,0 +1,34 @@
+import * as grpc from '@grpc/grpc-js';
+import * as protoLoader from '@grpc/proto-loader';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { getProtoPath } from 'google-proto-files';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const PROTO_ROOT = path.resolve(__dirname, '../../proto');
+// getProtoPath('.') resolves to .../google-proto-files/google, so its parent
+// is the include root that "google/protobuf/descriptor.proto" (imported by
+// mavsdk_options.proto) resolves against.
+const WELL_KNOWN_PROTO_ROOT = path.dirname(getProtoPath('.'));
+function loadPackage(protoRelativePath) {
+    const packageDefinition = protoLoader.loadSync(path.join(PROTO_ROOT, protoRelativePath), {
+        keepCase: false,
+        longs: String,
+        enums: String,
+        defaults: true,
+        oneofs: true,
+        includeDirs: [PROTO_ROOT, WELL_KNOWN_PROTO_ROOT],
+    });
+    return grpc.loadPackageDefinition(packageDefinition);
+}
+export function loadMavsdkClients(serverAddress) {
+    const credentials = grpc.credentials.createInsecure();
+    const actionPkg = loadPackage('action/action.proto');
+    const telemetryPkg = loadPackage('telemetry/telemetry.proto');
+    const missionPkg = loadPackage('mission/mission.proto');
+    return {
+        action: new actionPkg.mavsdk.rpc.action.ActionService(serverAddress, credentials),
+        telemetry: new telemetryPkg.mavsdk.rpc.telemetry.TelemetryService(serverAddress, credentials),
+        mission: new missionPkg.mavsdk.rpc.mission.MissionService(serverAddress, credentials),
+    };
+}
+//# sourceMappingURL=mavsdk-client.js.map

package/dist/grpc/mavsdk-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mavsdk-client.js","sourceRoot":"","sources":["../../src/grpc/mavsdk-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AACtC,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAC;AAClD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAC1D,6EAA6E;AAC7E,2EAA2E;AAC3E,0CAA0C;AAC1C,MAAM,qBAAqB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;AAE9D,SAAS,WAAW,CAAC,iBAAyB;IAC5C,MAAM,iBAAiB,GAAG,WAAW,CAAC,QAAQ,CAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,EACxC;QACE,QAAQ,EAAE,KAAK;QACf,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,CAAC,UAAU,EAAE,qBAAqB,CAAC;KACjD,CACF,CAAC;IACF,OAAO,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;AACvD,CAAC;AAQD,MAAM,UAAU,iBAAiB,CAAC,aAAqB;IACrD,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC;IAEtD,MAAM,SAAS,GAAG,WAAW,CAAC,qBAAqB,CAElD,CAAC;IACF,MAAM,YAAY,GAAG,WAAW,CAAC,2BAA2B,CAE3D,CAAC;IACF,MAAM,UAAU,GAAG,WAAW,CAAC,uBAAuB,CAErD,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,WAAW,CAA4B;QAC5G,SAAS,EAAE,IAAI,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,aAAa,EAAE,WAAW,CAA+B;QAC3H,OAAO,EAAE,IAAI,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,WAAW,CAA6B;KAClH,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { createOrchestrator } from './orchestrator.js';
+export type { OrchestratorInstance } from './orchestrator.js';
+export { createMavsdkVehicleAdapter } from './adapters/mavsdk-adapter.js';
+export { createHttpVlmClient } from './adapters/vlm-client.js';
+export { createMirilVlmClient } from './vlm/miril-client.js';
+export type { MirilPromptFamily, MirilVlmClientOptions } from './vlm/miril-client.js';
+export { createLandingZoneCheckMode } from './modes/landing-zone-check.js';
+export type { VisionAssistMode } from './modes/vision-assist-mode.js';
+export { loadMavsdkClients } from './grpc/mavsdk-client.js';
+export type { MavsdkClients } from './grpc/mavsdk-client.js';
+export { createStatusServer } from './server/status-server.js';
+export type { OrchestratorStatus, StatusServer, StatusServerOptions } from './server/status-server.js';
+export type { VehicleState, LandingCandidate, ModeVerdict, ConfirmDecision, VehicleAdapter, CameraSource, VlmClient, OrchestratorContext, OrchestratorConfig, ConfirmPolicy, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACvG,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,cAAc,EACd,YAAY,EACZ,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { createOrchestrator } from './orchestrator.js';
+export { createMavsdkVehicleAdapter } from './adapters/mavsdk-adapter.js';
+export { createHttpVlmClient } from './adapters/vlm-client.js';
+export { createMirilVlmClient } from './vlm/miril-client.js';
+export { createLandingZoneCheckMode } from './modes/landing-zone-check.js';
+export { loadMavsdkClients } from './grpc/mavsdk-client.js';
+export { createStatusServer } from './server/status-server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/modes/landing-zone-check.d.ts

@@ -0,0 +1,3 @@
+import type { VisionAssistMode } from './vision-assist-mode.js';
+export declare function createLandingZoneCheckMode(prompt?: string): VisionAssistMode;
+//# sourceMappingURL=landing-zone-check.d.ts.map

package/dist/modes/landing-zone-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing-zone-check.d.ts","sourceRoot":"","sources":["../../src/modes/landing-zone-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAwBhE,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,MAAuB,GAAG,gBAAgB,CAyC5F"}

package/dist/modes/landing-zone-check.js

@@ -0,0 +1,52 @@
+const DEFAULT_PROMPT = 'Assess whether this is a safe landing zone. If unsafe, point to a safer nearby spot.';
+function toCandidate(raw, currentLat, currentLon) {
+    if (!raw.point_2d)
+        return undefined;
+    // point_2d is [y, x] normalized image coordinates from the VLM's operational_coordinate_v2
+    // response family. Converting that to a real lat/lon offset requires camera intrinsics,
+    // altitude, and gimbal angle, which are supplied by the integrator's CameraSource, not this
+    // package. This mode reports the raw point plus a placeholder offset; integrators wire real
+    // ground-plane projection through their own CameraSource/VlmClient before this is production-safe.
+    return {
+        latitudeDeg: currentLat,
+        longitudeDeg: currentLon,
+        description: raw.description ?? 'candidate landing spot',
+    };
+}
+export function createLandingZoneCheckMode(prompt = DEFAULT_PROMPT) {
+    let lastCandidate;
+    return {
+        id: 'landing-zone-check',
+        shouldTrigger(vehicleState) {
+            return vehicleState.flightMode === 'LAND';
+        },
+        async evaluate(image, ctx) {
+            await ctx.vehicle.hold();
+            let raw;
+            try {
+                raw = (await ctx.vlm.query(image, prompt));
+            }
+            catch (err) {
+                return { status: 'unknown', reason: err instanceof Error ? err.message : String(err) };
+            }
+            if (raw.status === 'safe') {
+                lastCandidate = undefined;
+                return { status: 'safe' };
+            }
+            lastCandidate = toCandidate(raw, 0, 0);
+            return { status: 'unsafe', candidate: lastCandidate };
+        },
+        async onDecision(decision, ctx) {
+            if (decision.action === 'accept-candidate' && lastCandidate) {
+                await ctx.vehicle.gotoLocation({
+                    latitudeDeg: lastCandidate.latitudeDeg,
+                    longitudeDeg: lastCandidate.longitudeDeg,
+                    absoluteAltitudeM: 0,
+                });
+                return;
+            }
+            await ctx.vehicle.resumeMission();
+        },
+    };
+}
+//# sourceMappingURL=landing-zone-check.js.map

package/dist/modes/landing-zone-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing-zone-check.js","sourceRoot":"","sources":["../../src/modes/landing-zone-check.ts"],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAG,sFAAsF,CAAC;AAQ9G,SAAS,WAAW,CAAC,GAAmB,EAAE,UAAkB,EAAE,UAAkB;IAC9E,IAAI,CAAC,GAAG,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IACpC,2FAA2F;IAC3F,wFAAwF;IACxF,4FAA4F;IAC5F,4FAA4F;IAC5F,mGAAmG;IACnG,OAAO;QACL,WAAW,EAAE,UAAU;QACvB,YAAY,EAAE,UAAU;QACxB,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,wBAAwB;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,SAAiB,cAAc;IACxE,IAAI,aAA2C,CAAC;IAEhD,OAAO;QACL,EAAE,EAAE,oBAAoB;QAExB,aAAa,CAAC,YAAY;YACxB,OAAO,YAAY,CAAC,UAAU,KAAK,MAAM,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG;YACvB,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAEzB,IAAI,GAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAmB,CAAC;YAC/D,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACzF,CAAC;YAED,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC1B,aAAa,GAAG,SAAS,CAAC;gBAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YAC5B,CAAC;YAED,aAAa,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACvC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;QACxD,CAAC;QAED,KAAK,CAAC,UAAU,CAAC,QAAyB,EAAE,GAAwB;YAClE,IAAI,QAAQ,CAAC,MAAM,KAAK,kBAAkB,IAAI,aAAa,EAAE,CAAC;gBAC5D,MAAM,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC;oBAC7B,WAAW,EAAE,aAAa,CAAC,WAAW;oBACtC,YAAY,EAAE,aAAa,CAAC,YAAY;oBACxC,iBAAiB,EAAE,CAAC;iBACrB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,MAAM,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/modes/vision-assist-mode.d.ts

@@ -0,0 +1,8 @@
+import type { ConfirmDecision, ModeVerdict, OrchestratorContext, VehicleState } from '../types.js';
+export interface VisionAssistMode {
+    readonly id: string;
+    shouldTrigger(vehicleState: VehicleState): boolean;
+    evaluate(image: Buffer, ctx: OrchestratorContext): Promise<ModeVerdict>;
+    onDecision(decision: ConfirmDecision, ctx: OrchestratorContext): Promise<void>;
+}
+//# sourceMappingURL=vision-assist-mode.d.ts.map

package/dist/modes/vision-assist-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-assist-mode.d.ts","sourceRoot":"","sources":["../../src/modes/vision-assist-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEnG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxE,UAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF"}

package/dist/modes/vision-assist-mode.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=vision-assist-mode.js.map

package/dist/modes/vision-assist-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-assist-mode.js","sourceRoot":"","sources":["../../src/modes/vision-assist-mode.ts"],"names":[],"mappings":""}

package/dist/orchestrator.d.ts

@@ -0,0 +1,13 @@
+import type { OrchestratorConfig, VehicleAdapter } from './types.js';
+import type { VisionAssistMode } from './modes/vision-assist-mode.js';
+export interface OrchestratorInstance {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+}
+type FullOrchestratorConfig = OrchestratorConfig & {
+    modes: VisionAssistMode[];
+    vehicleAdapterOverride?: VehicleAdapter;
+};
+export declare function createOrchestrator(config: FullOrchestratorConfig): OrchestratorInstance;
+export {};
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAA4C,MAAM,YAAY,CAAC;AAC/G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,WAAW,oBAAoB;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,KAAK,sBAAsB,GAAG,kBAAkB,GAAG;IACjD,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,sBAAsB,CAAC,EAAE,cAAc,CAAC;CACzC,CAAC;AAIF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,oBAAoB,CAwHvF"}

package/dist/orchestrator.js

@@ -0,0 +1,106 @@
+import { loadMavsdkClients } from './grpc/mavsdk-client.js';
+import { createMavsdkVehicleAdapter } from './adapters/mavsdk-adapter.js';
+import { createStatusServer } from './server/status-server.js';
+const MAX_REEVALUATION_ATTEMPTS = 3;
+export function createOrchestrator(config) {
+    const mavsdkClients = config.vehicleAdapterOverride
+        ? null
+        : loadMavsdkClients(config.mavsdkServerAddress);
+    const vehicle = config.vehicleAdapterOverride ?? createMavsdkVehicleAdapter(mavsdkClients);
+    const statusServer = createStatusServer({
+        port: config.statusServerPort,
+        onConfirm: (decision) => handleConfirm(decision),
+    });
+    let activeMode = null;
+    let unsubscribe = null;
+    let pendingResolve = null;
+    function handleConfirm(decision) {
+        if (!pendingResolve)
+            return;
+        const resolve = pendingResolve;
+        pendingResolve = null;
+        resolve(decision);
+    }
+    async function evaluateOnce(mode, ctx) {
+        const image = await config.cameraSource.captureFrame();
+        const verdict = await mode.evaluate(image, ctx);
+        if (verdict.status === 'safe') {
+            await vehicle.resumeMission();
+            return 'safe';
+        }
+        if (config.confirmPolicy === 'autonomous') {
+            await mode.onDecision({ action: 'accept-candidate' }, ctx);
+            return 'repositioned';
+        }
+        statusServer.setStatus({
+            state: 'awaiting-confirm',
+            verdict: verdict.status === 'unsafe'
+                ? { status: 'unsafe', candidate: verdict.candidate }
+                : { status: 'unknown' },
+        });
+        const decision = await new Promise((resolve) => {
+            pendingResolve = resolve;
+        });
+        await mode.onDecision(decision, ctx);
+        if (decision.action === 'reject') {
+            return 'safe'; // resolved: onDecision already resumed the original landing
+        }
+        return 'repositioned';
+    }
+    async function runMode(mode) {
+        activeMode = mode;
+        statusServer.setStatus({ state: 'holding' });
+        const ctx = { vehicle, camera: config.cameraSource, vlm: config.vlmClient };
+        for (let attempt = 1; attempt <= MAX_REEVALUATION_ATTEMPTS; attempt += 1) {
+            const outcome = await evaluateOnce(mode, ctx);
+            if (outcome === 'safe') {
+                statusServer.setStatus({ state: 'idle' });
+                activeMode = null;
+                return;
+            }
+            // outcome === 'repositioned': loop again to re-evaluate the new position,
+            // up to MAX_REEVALUATION_ATTEMPTS total.
+        }
+        statusServer.setStatus({ state: 'no-safe-alternative' });
+        activeMode = null;
+    }
+    async function verifyMavsdkServerReachable() {
+        if (!mavsdkClients)
+            return; // test/mock adapters skip the real connectivity check
+        // isMissionFinished is documented as a SYNC, read-only RPC in mission.proto - safe to use
+        // purely as a "did the server answer" probe, unlike resumeMission/hold/gotoLocation which
+        // all have real side effects on the vehicle.
+        await new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => reject(new Error(`Could not reach mavsdk_server at ${config.mavsdkServerAddress} within 5s`)), 5000);
+            const isMissionFinished = mavsdkClients.mission.isMissionFinished;
+            isMissionFinished({}, (err) => {
+                clearTimeout(timeout);
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    return {
+        async start() {
+            await verifyMavsdkServerReachable();
+            await statusServer.start();
+            unsubscribe = vehicle.subscribeFlightMode((state) => {
+                if (activeMode)
+                    return;
+                for (const mode of config.modes) {
+                    if (mode.shouldTrigger(state)) {
+                        void runMode(mode);
+                        break;
+                    }
+                }
+            });
+        },
+        async stop() {
+            unsubscribe?.();
+            await statusServer.stop();
+        },
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"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"}