@agenticros/core 0.5.0

package/dist/discovery.js

@@ -0,0 +1,141 @@
+/**
+ * Multi-robot discovery — Phase 1.d "fleet awareness on the wire".
+ *
+ * Configuration tells the gateway what robots the user wants to talk to.
+ * The transport tells the gateway what's actually on the wire right now.
+ * Discovery is the bridge: scan published ROS2 topics, infer robot
+ * namespaces from `<ns>/cmd_vel` patterns, cross-reference against the
+ * configured robot list, and surface three categories:
+ *
+ *   1. configured_online   — in config AND seen on the wire
+ *   2. configured_offline  — in config but NOT seen on the wire
+ *   3. unknown_detected    — on the wire but NOT in config
+ *
+ * The agent uses this to answer questions like "which robots can I talk
+ * to right now?" without forcing the user to hand-edit
+ * `~/.agenticros/config.json` every time a robot joins the network.
+ *
+ * Persistence is intentionally OUT of scope here: discovery is read-only.
+ * Writing newly-detected robots into the user's config is a separate
+ * UX decision handled by the CLI / OpenClaw config UI on top of this
+ * function.
+ *
+ * ## Detection signal
+ *
+ * `<ns>/cmd_vel` (the velocity command topic) is the canonical signal —
+ * a robot that can be driven publishes/subscribes there. Other topics
+ * like `<ns>/odom`, `<ns>/joint_states`, and `<ns>/camera/...` corroborate
+ * the same `<ns>`; we surface them as `topicCount` so consumers can
+ * gauge how "alive" the namespace looks.
+ *
+ * The unnamespaced `/cmd_vel` topic (default namespace, common in
+ * simulation) is detected as id="" — consumers can render it as
+ * "default robot" or similar.
+ *
+ * ## Namespace rewrite
+ *
+ * `ros2_publish` rewrites a UUID-shaped namespace like
+ * `3946b404-c33e-...` into `robot3946b404c33e...` (strip dashes,
+ * prefix with "robot") because most robot firmware expects the
+ * dashless form. Discovery applies the same rewrite when matching
+ * configured robots against detected namespaces, so a UUID-style
+ * config entry still matches the `/robot<no-dashes>/cmd_vel` topic
+ * the robot is actually publishing on.
+ */
+import { listRobots } from "./robots.js";
+/**
+ * Apply the same UUID→robot-no-dashes rewrite as `ros2_publish` uses
+ * when normalising a `/<ns>/cmd_vel` target.
+ *
+ * `""` stays `""` (default namespace). Namespaces that already start
+ * with "robot" are returned unchanged.
+ */
+export function effectiveCmdVelNamespace(robotNamespace) {
+    const ns = robotNamespace.trim();
+    if (ns === "")
+        return "";
+    if (ns.toLowerCase().startsWith("robot"))
+        return ns;
+    return `robot${ns.replace(/-/g, "")}`;
+}
+/**
+ * Find every robot-shaped namespace in a topic list.
+ *
+ * Detection rule: any `/<seg>/cmd_vel` topic implies a robot with
+ * namespace `<seg>`. The unnamespaced `/cmd_vel` topic registers the
+ * empty namespace (id=""). Topic count under each namespace is
+ * accumulated so consumers can rank by liveness.
+ *
+ * The returned `DetectedRobot.configuredRobotId` is always `null` here —
+ * call `discoverRobots()` (which wraps this function) to annotate with
+ * config matches.
+ */
+export function detectRobotsFromTopics(topics) {
+    const byNs = new Map();
+    for (const t of topics) {
+        // Match /<seg>/cmd_vel exactly — sub-namespaces would imply a more
+        // complex robot graph than this v1 wants to handle.
+        const m = t.name.match(/^\/([^/]+)\/cmd_vel$/);
+        if (m) {
+            const ns = m[1];
+            if (!byNs.has(ns))
+                byNs.set(ns, { cmdVelTopic: t.name, topicCount: 0 });
+        }
+        else if (t.name === "/cmd_vel" && !byNs.has("")) {
+            byNs.set("", { cmdVelTopic: "/cmd_vel", topicCount: 0 });
+        }
+    }
+    // Count topics under each detected namespace. Empty-namespace robots
+    // (default) intentionally don't accumulate counts — every topic in
+    // the system would otherwise "belong" to them, which is misleading.
+    for (const t of topics) {
+        for (const [ns, info] of byNs) {
+            if (ns === "")
+                continue;
+            if (t.name.startsWith(`/${ns}/`)) {
+                info.topicCount += 1;
+            }
+        }
+    }
+    return Array.from(byNs.entries()).map(([id, info]) => ({
+        id,
+        cmdVelTopic: info.cmdVelTopic,
+        topicCount: info.topicCount,
+        configuredRobotId: null,
+    }));
+}
+/**
+ * Top-level discovery: detect robots on the wire, match against the
+ * configured robot list, and classify into online / offline / unknown.
+ *
+ * Pure function — feed it the topic list and the config, get a result
+ * back. No transport access here; adapters wrap this with a call to
+ * `transport.listTopics()`.
+ */
+export function discoverRobots(topics, config) {
+    const detected = detectRobotsFromTopics(topics);
+    const configured = listRobots(config);
+    // Map effective-namespace → configured robot for O(1) lookup.
+    const effToCfg = new Map();
+    for (const r of configured) {
+        effToCfg.set(effectiveCmdVelNamespace(r.namespace), r);
+    }
+    const annotated = detected.map((d) => {
+        const cfg = effToCfg.get(d.id);
+        return cfg
+            ? { ...d, configuredRobotId: cfg.id }
+            : { ...d, configuredRobotId: null };
+    });
+    const detectedIds = new Set(annotated.map((d) => d.id));
+    const configured_online = configured.filter((r) => detectedIds.has(effectiveCmdVelNamespace(r.namespace)));
+    const configured_offline = configured.filter((r) => !detectedIds.has(effectiveCmdVelNamespace(r.namespace)));
+    const unknown_detected = annotated.filter((d) => d.configuredRobotId === null);
+    return {
+        detected: annotated,
+        configured_online,
+        configured_offline,
+        unknown_detected,
+        total_topics: topics.length,
+    };
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAwCzC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,cAAsB;IAC7D,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IACzB,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACpD,OAAO,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACxD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAuD,CAAC;IAE5E,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,mEAAmE;QACnE,oDAAoD;QACpD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAC/C,IAAI,CAAC,EAAE,CAAC;YACN,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACjB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1E,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,qEAAqE;IACrE,mEAAmE;IACnE,oEAAoE;IACpE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAC9B,IAAI,EAAE,KAAK,EAAE;gBAAE,SAAS;YACxB,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,EAAE;QACF,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAmB,EACnB,MAAwB;IAExB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAEtC,8DAA8D;IAC9D,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,QAAQ,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/B,OAAO,GAAG;YACR,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,iBAAiB,EAAE,GAAG,CAAC,EAAE,EAAE;YACrC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,iBAAiB,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAChD,WAAW,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CACvD,CAAC;IACF,MAAM,kBAAkB,GAAG,UAAU,CAAC,MAAM,CAC1C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAC/D,CAAC;IACF,MAAM,gBAAgB,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC;IAE/E,OAAO;QACL,QAAQ,EAAE,SAAS;QACnB,iBAAiB;QACjB,kBAAkB;QAClB,gBAAgB;QAChB,YAAY,EAAE,MAAM,CAAC,MAAM;KAC5B,CAAC;AACJ,CAAC"}

package/dist/find-robots-for.d.ts

@@ -0,0 +1,85 @@
+/**
+ * `findRobotsFor` — Phase 1.e capability-aware robot filter.
+ *
+ * Given a (capability?, kind?, online?) query, returns the configured
+ * robots that match, ranked best-first. This is the resolver behind the
+ * `ros2_find_robots_for` MCP tool — adapters call it from `tools.ts`
+ * with the live online-set computed from a topic scan (or `undefined`
+ * when `online` isn't being filtered, so we don't pay for the scan).
+ *
+ * Filter semantics:
+ *  - `capability` — keep robots whose per-robot allowlist
+ *    (`config.robots[i].capabilities`) includes the verb, OR (when no
+ *    allowlist is set) whose gateway's global capability registry
+ *    includes it. The global path is the common case — every robot
+ *    today exposes the same builtin + skill-declared capabilities. The
+ *    per-robot allowlist exists for heterogeneous fleets where (e.g.)
+ *    only one robot has the `arm_skill` loaded.
+ *  - `kind` — exact match on `robot.kind` (case-insensitive). Use
+ *    "amr" / "arm" / "drone" / "rover" by convention but any string is
+ *    accepted by the schema.
+ *  - `online` — `true` keeps only robots whose id is in `onlineIds`;
+ *    `false` keeps only robots NOT in `onlineIds`; `undefined` skips
+ *    this filter entirely. The adapter is responsible for populating
+ *    `onlineIds` from the live topic graph (typically via
+ *    `discoverRobots()`) before calling this — core doesn't touch the
+ *    transport.
+ *
+ * Ranking (highest score first):
+ *   +2  online (when query.online is true)
+ *   +1  per-robot capabilities allowlist included the requested verb
+ *       (an explicit "I support this" beats a global-registry inference)
+ *   +0  default tier
+ *
+ * Ties broken by config declaration order (stable).
+ *
+ * Why not a full LLM-style scoring function? Phase 1.e's goal is
+ * deterministic and explainable — an agent calling `find_robots_for`
+ * wants a list it can plan against, not a relevance heuristic. The
+ * +1/+2 deltas are enough to surface a perfect match above an
+ * inherited one without inventing fuzzy matching.
+ */
+import type { AgenticROSConfig } from "./config.js";
+import { type ResolvedRobot } from "./robots.js";
+/** Query input to `findRobotsFor`. All fields optional → returns every robot. */
+export interface FindRobotsForQuery {
+    /** Capability id (e.g. `follow_person`, `find_object`). Case-sensitive — match the registry. */
+    capability?: string;
+    /** Robot kind (e.g. `amr`, `arm`, `drone`). Case-insensitive. */
+    kind?: string;
+    /** When set, restrict to online (true) or offline (false) robots. */
+    online?: boolean;
+}
+/** One entry in the find-robots-for result. */
+export interface FindRobotsForMatch {
+    robot: ResolvedRobot;
+    /** True when the capability filter was satisfied by an explicit per-robot allowlist. */
+    matched_capability_explicitly: boolean;
+    /**
+     * True when this robot is in the caller-supplied online set, false when
+     * not, and `null` when the caller didn't provide an online set at all
+     * (so we can't say either way).
+     */
+    online: boolean | null;
+    /** Sort key — higher = better match. See module header for the formula. */
+    score: number;
+}
+/** Result envelope. */
+export interface FindRobotsForResult {
+    query: FindRobotsForQuery;
+    total: number;
+    /** Best-matching robots first. */
+    robots: FindRobotsForMatch[];
+}
+/**
+ * Run the filter+rank against the configured fleet.
+ *
+ * `onlineIds` is optional. When omitted AND `query.online` is set, this
+ * throws — the adapter MUST resolve the live set before calling this so
+ * the core stays transport-agnostic.
+ *
+ * The match list is stable across calls with the same input (no
+ * non-determinism, no time-of-day effects).
+ */
+export declare function findRobotsFor(config: AgenticROSConfig, query: FindRobotsForQuery, onlineIds?: ReadonlySet<string>): FindRobotsForResult;
+//# sourceMappingURL=find-robots-for.d.ts.map

package/dist/find-robots-for.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-robots-for.d.ts","sourceRoot":"","sources":["../src/find-robots-for.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE7D,iFAAiF;AACjF,MAAM,WAAW,kBAAkB;IACjC,gGAAgG;IAChG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,aAAa,CAAC;IACrB,wFAAwF;IACxF,6BAA6B,EAAE,OAAO,CAAC;IACvC;;;;OAIG;IACH,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uBAAuB;AACvB,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,kBAAkB,EACzB,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,mBAAmB,CAsErB"}

package/dist/find-robots-for.js

@@ -0,0 +1,120 @@
+/**
+ * `findRobotsFor` — Phase 1.e capability-aware robot filter.
+ *
+ * Given a (capability?, kind?, online?) query, returns the configured
+ * robots that match, ranked best-first. This is the resolver behind the
+ * `ros2_find_robots_for` MCP tool — adapters call it from `tools.ts`
+ * with the live online-set computed from a topic scan (or `undefined`
+ * when `online` isn't being filtered, so we don't pay for the scan).
+ *
+ * Filter semantics:
+ *  - `capability` — keep robots whose per-robot allowlist
+ *    (`config.robots[i].capabilities`) includes the verb, OR (when no
+ *    allowlist is set) whose gateway's global capability registry
+ *    includes it. The global path is the common case — every robot
+ *    today exposes the same builtin + skill-declared capabilities. The
+ *    per-robot allowlist exists for heterogeneous fleets where (e.g.)
+ *    only one robot has the `arm_skill` loaded.
+ *  - `kind` — exact match on `robot.kind` (case-insensitive). Use
+ *    "amr" / "arm" / "drone" / "rover" by convention but any string is
+ *    accepted by the schema.
+ *  - `online` — `true` keeps only robots whose id is in `onlineIds`;
+ *    `false` keeps only robots NOT in `onlineIds`; `undefined` skips
+ *    this filter entirely. The adapter is responsible for populating
+ *    `onlineIds` from the live topic graph (typically via
+ *    `discoverRobots()`) before calling this — core doesn't touch the
+ *    transport.
+ *
+ * Ranking (highest score first):
+ *   +2  online (when query.online is true)
+ *   +1  per-robot capabilities allowlist included the requested verb
+ *       (an explicit "I support this" beats a global-registry inference)
+ *   +0  default tier
+ *
+ * Ties broken by config declaration order (stable).
+ *
+ * Why not a full LLM-style scoring function? Phase 1.e's goal is
+ * deterministic and explainable — an agent calling `find_robots_for`
+ * wants a list it can plan against, not a relevance heuristic. The
+ * +1/+2 deltas are enough to surface a perfect match above an
+ * inherited one without inventing fuzzy matching.
+ */
+import { listAllCapabilities } from "./capabilities.js";
+import { listRobots } from "./robots.js";
+/**
+ * Run the filter+rank against the configured fleet.
+ *
+ * `onlineIds` is optional. When omitted AND `query.online` is set, this
+ * throws — the adapter MUST resolve the live set before calling this so
+ * the core stays transport-agnostic.
+ *
+ * The match list is stable across calls with the same input (no
+ * non-determinism, no time-of-day effects).
+ */
+export function findRobotsFor(config, query, onlineIds) {
+    if (query.online !== undefined && onlineIds === undefined) {
+        throw new Error("findRobotsFor: query.online was set but onlineIds was not provided. " +
+            "Call discoverRobots() first and pass configured_online ids.");
+    }
+    // Resolve the global capability registry once — used as the fallback
+    // when a robot doesn't declare its own per-robot allowlist.
+    const globalCapIds = new Set(listAllCapabilities(config).map((c) => c.id));
+    const wantedKind = query.kind?.trim().toLowerCase();
+    const wantedCap = query.capability?.trim();
+    const fleet = listRobots(config);
+    const matches = [];
+    for (const robot of fleet) {
+        // kind filter
+        if (wantedKind && robot.kind.toLowerCase() !== wantedKind)
+            continue;
+        // capability filter
+        let matchedExplicitly = false;
+        if (wantedCap) {
+            const allowlist = robot.capabilities;
+            if (allowlist) {
+                if (!allowlist.includes(wantedCap))
+                    continue;
+                matchedExplicitly = true;
+            }
+            else {
+                // No per-robot allowlist → fall back to the gateway-wide
+                // registry. This is the common case today.
+                if (!globalCapIds.has(wantedCap))
+                    continue;
+            }
+        }
+        // online filter
+        let isOnline = null;
+        if (onlineIds) {
+            isOnline = onlineIds.has(robot.id);
+            if (query.online === true && !isOnline)
+                continue;
+            if (query.online === false && isOnline)
+                continue;
+        }
+        let score = 0;
+        if (matchedExplicitly)
+            score += 1;
+        if (query.online === true && isOnline)
+            score += 2;
+        // Reward online robots even when the user didn't filter for it —
+        // an agent picking a robot for an action almost always wants the
+        // one currently reachable.
+        if (query.online === undefined && isOnline === true)
+            score += 1;
+        matches.push({ robot, matched_capability_explicitly: matchedExplicitly, online: isOnline, score });
+    }
+    // Stable sort: higher score first, tie-broken by original config
+    // order (which is what listRobots() returned).
+    matches.sort((a, b) => b.score - a.score);
+    return {
+        query: {
+            ...(wantedCap ? { capability: wantedCap } : {}),
+            ...(wantedKind ? { kind: wantedKind } : {}),
+            ...(query.online !== undefined ? { online: query.online } : {}),
+        },
+        total: matches.length,
+        robots: matches,
+    };
+}
+//# sourceMappingURL=find-robots-for.js.map

package/dist/find-robots-for.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @agenticros/core — Platform-agnostic ROS2 transport, config, and utilities.
+ */
+export type { AgenticROSConfig, RobotTransportOverride } from "./config.js";
+export { AgenticROSConfigSchema, parseConfig, getTransportConfig, } from "./config.js";
+export { createTransport } from "./transport/factory.js";
+export type { RosTransport } from "./transport/transport.js";
+export type { ConnectionStatus, ConnectionHandler, Subscription, PublishOptions, AdvertiseOptions, SubscribeOptions, ServiceCallOptions, ServiceCallResult, ActionGoalOptions, ActionResult, TopicInfo, ServiceInfo, ActionInfo, MessageHandler, TransportConfig, } from "./transport/types.js";
+export { toNamespacedTopic, toNamespacedTopicFull, toTeleopCameraTopicShort, resolveCameraSubscribeTopic, } from "./topic-utils.js";
+export { applyCmdVelTwistSignConvention } from "./cmd-vel-twist.js";
+export { isCdrTypeSupported } from "./transport/zenoh/cdr.js";
+export { renderAgenticROSBanner, agenticROSBannerLines, type AgenticROSBannerOptions, } from "./banner.js";
+export { createMemory, resolveMemoryNamespace } from "./memory/index.js";
+export type { MemoryProvider, MemoryRecord, MemoryStatus, RememberInput, RecallInput, ForgetInput, } from "./memory/index.js";
+export { BUILTIN_CAPABILITIES, readSkillCapabilities, listAllCapabilities, } from "./capabilities.js";
+export type { Capability, CapabilityField, CapabilityImplementation, CapabilitySource, } from "./capabilities.js";
+export { runMission } from "./mission.js";
+export type { Mission, MissionStep, MissionResult, MissionStepResult, MissionToolDispatcher, CapabilityToolBinding, CapabilityToolBindings, MissionCancellationToken, MissionTranscriptEntry, MissionTranscriptSink, RunMissionOptions, } from "./mission.js";
+export { MissionRegistry, generateMissionId, missionTranscriptNamespace, } from "./mission-registry.js";
+export type { MissionRegistryEntry } from "./mission-registry.js";
+export { createMemoryTranscriptSink } from "./mission-transcript-sink.js";
+export { compileGoalToMission } from "./planner/index.js";
+export type { PlannerResult, PlannerCandidate } from "./planner/index.js";
+export { listRobots, resolveRobot, resolveRobotFromArgs, getActiveRobotId, getTransportConfigForRobot, hasRobotTransportOverride, } from "./robots.js";
+export type { ResolvedRobot, RobotSensors } from "./robots.js";
+export { detectRobotsFromTopics, discoverRobots, effectiveCmdVelNamespace, } from "./discovery.js";
+export type { DetectedRobot, RobotDiscoveryResult } from "./discovery.js";
+export { findRobotsFor } from "./find-robots-for.js";
+export type { FindRobotsForQuery, FindRobotsForMatch, FindRobotsForResult, } from "./find-robots-for.js";
+export { TransportPool, TRANSPORT_POOL_GLOBAL_KEY } from "./transport-pool.js";
+export type { TransportFactory } from "./transport-pool.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;;GAEG;AAEH,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,UAAU,EACV,eAAe,EACf,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,OAAO,EACP,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EACL,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @agenticros/core — Platform-agnostic ROS2 transport, config, and utilities.
+ */
+export { AgenticROSConfigSchema, parseConfig, getTransportConfig, } from "./config.js";
+export { createTransport } from "./transport/factory.js";
+export { toNamespacedTopic, toNamespacedTopicFull, toTeleopCameraTopicShort, resolveCameraSubscribeTopic, } from "./topic-utils.js";
+export { applyCmdVelTwistSignConvention } from "./cmd-vel-twist.js";
+export { isCdrTypeSupported } from "./transport/zenoh/cdr.js";
+export { renderAgenticROSBanner, agenticROSBannerLines, } from "./banner.js";
+export { createMemory, resolveMemoryNamespace } from "./memory/index.js";
+export { BUILTIN_CAPABILITIES, readSkillCapabilities, listAllCapabilities, } from "./capabilities.js";
+export { runMission } from "./mission.js";
+export { MissionRegistry, generateMissionId, missionTranscriptNamespace, } from "./mission-registry.js";
+export { createMemoryTranscriptSink } from "./mission-transcript-sink.js";
+export { compileGoalToMission } from "./planner/index.js";
+export { listRobots, resolveRobot, resolveRobotFromArgs, getActiveRobotId, getTransportConfigForRobot, hasRobotTransportOverride, } from "./robots.js";
+export { detectRobotsFromTopics, discoverRobots, effectiveCmdVelNamespace, } from "./discovery.js";
+export { findRobotsFor } from "./find-robots-for.js";
+export { TransportPool, TRANSPORT_POOL_GLOBAL_KEY } from "./transport-pool.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;;GAEG;AAGH,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAoBzD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,qBAAqB,GAEtB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAUzE,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAe1C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EACL,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/memory/factory.d.ts

@@ -0,0 +1,18 @@
+import type { AgenticROSConfig } from "../config.js";
+import type { MemoryProvider } from "./types.js";
+/**
+ * Build a MemoryProvider from full config.
+ *
+ * Returns `null` when memory is disabled (`config.memory.enabled === false`),
+ * so adapters can short-circuit registering memory tools.
+ *
+ * The mem0 backend is loaded via dynamic import — `mem0ai` is an optional peer
+ * dependency. Users on `backend: "local"` never load it.
+ */
+export declare function createMemory(config: AgenticROSConfig): Promise<MemoryProvider | null>;
+/**
+ * Resolve the effective namespace used by memory tools.
+ * Argument > config.memory.namespace > config.robot.namespace.
+ */
+export declare function resolveMemoryNamespace(config: AgenticROSConfig, argNamespace?: string): string;
+//# sourceMappingURL=factory.d.ts.map

package/dist/memory/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/memory/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8BhC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CASR"}

package/dist/memory/factory.js

@@ -0,0 +1,51 @@
+/**
+ * Build a MemoryProvider from full config.
+ *
+ * Returns `null` when memory is disabled (`config.memory.enabled === false`),
+ * so adapters can short-circuit registering memory tools.
+ *
+ * The mem0 backend is loaded via dynamic import — `mem0ai` is an optional peer
+ * dependency. Users on `backend: "local"` never load it.
+ */
+export async function createMemory(config) {
+    if (!config.memory?.enabled)
+        return null;
+    const backend = config.memory.backend;
+    switch (backend) {
+        case "local": {
+            const { LocalMemoryProvider } = await import("./local/provider.js");
+            return new LocalMemoryProvider({
+                storePath: config.memory.local.storePath,
+            });
+        }
+        case "mem0": {
+            const { createMem0Provider } = await import("./mem0/provider.js");
+            return await createMem0Provider({
+                config: {
+                    inferOnWrite: config.memory.mem0.inferOnWrite,
+                    historyDbPath: config.memory.mem0.historyDbPath,
+                    embedder: config.memory.mem0.embedder,
+                    vectorStore: config.memory.mem0.vectorStore,
+                    llm: config.memory.mem0.llm,
+                },
+            });
+        }
+        default: {
+            const _exhaustive = backend;
+            throw new Error(`Unknown memory backend: ${String(_exhaustive)}`);
+        }
+    }
+}
+/**
+ * Resolve the effective namespace used by memory tools.
+ * Argument > config.memory.namespace > config.robot.namespace.
+ */
+export function resolveMemoryNamespace(config, argNamespace) {
+    return ((argNamespace && argNamespace.trim().length > 0 ? argNamespace : undefined) ??
+        (config.memory?.namespace && config.memory.namespace.trim().length > 0
+            ? config.memory.namespace
+            : undefined) ??
+        config.robot?.namespace ??
+        "");
+}
+//# sourceMappingURL=factory.js.map

package/dist/memory/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../src/memory/factory.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAwB;IAExB,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;IACtC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;YACpE,OAAO,IAAI,mBAAmB,CAAC;gBAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS;aACzC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAClE,OAAO,MAAM,kBAAkB,CAAC;gBAC9B,MAAM,EAAE;oBACN,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY;oBAC7C,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa;oBAC/C,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ;oBACrC,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW;oBAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;iBAC5B;aACF,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,OAAO,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAwB,EACxB,YAAqB;IAErB,OAAO,CACL,CAAC,YAAY,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACpE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS;YACzB,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,CAAC,KAAK,EAAE,SAAS;QACvB,EAAE,CACH,CAAC;AACJ,CAAC"}

package/dist/memory/index.d.ts

@@ -0,0 +1,3 @@
+export type { ForgetInput, MemoryProvider, MemoryRecord, MemoryStatus, RecallInput, RememberInput, } from "./types.js";
+export { createMemory, resolveMemoryNamespace } from "./factory.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/memory/index.js

@@ -0,0 +1,2 @@
+export { createMemory, resolveMemoryNamespace } from "./factory.js";
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC"}

package/dist/memory/local/provider.d.ts

@@ -0,0 +1,29 @@
+import type { ForgetInput, MemoryProvider, MemoryRecord, MemoryStatus, RecallInput, RememberInput } from "../types.js";
+interface LocalConfig {
+    storePath: string;
+}
+/**
+ * Tiny JSON-on-disk memory backend. No new deps.
+ *
+ * Recall ranks by token-overlap score (tf-style) with a small recency bonus
+ * so two equally-relevant memories are returned newest-first. This is
+ * intentionally dumb — users who want true semantic search opt into mem0.
+ */
+export declare class LocalMemoryProvider implements MemoryProvider {
+    readonly backend: "local";
+    private readonly storePath;
+    private records;
+    private writeChain;
+    constructor(config: LocalConfig);
+    remember(input: RememberInput): Promise<MemoryRecord>;
+    recall(input: RecallInput): Promise<MemoryRecord[]>;
+    forget(input: ForgetInput): Promise<{
+        removed: number;
+    }>;
+    status(namespace: string): Promise<MemoryStatus>;
+    recent(namespace: string, limit?: number): Promise<MemoryRecord[]>;
+    private load;
+    private persist;
+}
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/memory/local/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/memory/local/provider.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IACxD,QAAQ,CAAC,OAAO,EAAG,OAAO,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAA+B;IAC9C,OAAO,CAAC,UAAU,CAAoC;gBAE1C,MAAM,EAAE,WAAW;IAIzB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBrD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAyBnD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA6BxD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgBhD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAUrD,IAAI;YAyBJ,OAAO;CAatB"}