@soleri/core 2.10.0 → 2.12.0

package/dist/plugins/plugin-registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Plugin Registry — tracks loaded plugins and their lifecycle.
+ *
+ * Not a singleton — lives on AgentRuntime for testability.
+ * Lifecycle: load → register → activate → (deactivate | error)
+ */
+import type { LoadedPlugin, RegisteredPlugin, PluginContext } from './types.js';
+import type { FacadeConfig, OpDefinition } from '../facades/types.js';
+export declare class PluginRegistry {
+    private plugins;
+    /**
+     * Register a loaded plugin. Does NOT activate it — call activate() separately.
+     */
+    register(loaded: LoadedPlugin): RegisteredPlugin;
+    /**
+     * Activate a plugin — builds facades from its manifest or JS module.
+     *
+     * If the plugin directory contains an `index.js` with a `createFacades` export,
+     * that function is called to build facades dynamically. Otherwise, facade stubs
+     * are created from the manifest's `facades` array (static ops with no-op handlers).
+     */
+    activate(pluginId: string, ctx: PluginContext): Promise<RegisteredPlugin>;
+    /**
+     * Deactivate a plugin — removes its facades from the runtime.
+     */
+    deactivate(pluginId: string): boolean;
+    /**
+     * Unregister a plugin completely.
+     */
+    unregister(pluginId: string): boolean;
+    /**
+     * Get a registered plugin by ID.
+     */
+    get(pluginId: string): RegisteredPlugin | undefined;
+    /**
+     * List all registered plugins.
+     */
+    list(): RegisteredPlugin[];
+    /**
+     * Get all active facades from all active plugins.
+     */
+    getActiveFacades(): FacadeConfig[];
+    /**
+     * Get all active ops (flattened from all active plugin facades).
+     */
+    getActiveOps(): OpDefinition[];
+    /**
+     * Try to load a JS module with `createFacades` export from the plugin directory.
+     * Returns null if no module found or no export.
+     */
+    private tryLoadFacadeBuilder;
+    /**
+     * Build facade configs from the manifest's static facade definitions.
+     * These have no-op handlers — useful for schema discovery and documentation.
+     */
+    private buildStaticFacades;
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/plugins/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EAEd,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKtE,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAuC;IAEtD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB;IAoBhD;;;;;;OAMG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA0B/E;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASrC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAWrC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAInD;;OAEG;IACH,IAAI,IAAI,gBAAgB,EAAE;IAI1B;;OAEG;IACH,gBAAgB,IAAI,YAAY,EAAE;IAUlC;;OAEG;IACH,YAAY,IAAI,YAAY,EAAE;IAM9B;;;OAGG;YACW,oBAAoB;IAyBlC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;CAc3B"}

package/dist/plugins/plugin-registry.js

@@ -0,0 +1,157 @@
+/**
+ * Plugin Registry — tracks loaded plugins and their lifecycle.
+ *
+ * Not a singleton — lives on AgentRuntime for testability.
+ * Lifecycle: load → register → activate → (deactivate | error)
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+export class PluginRegistry {
+    plugins = new Map();
+    /**
+     * Register a loaded plugin. Does NOT activate it — call activate() separately.
+     */
+    register(loaded) {
+        const existing = this.plugins.get(loaded.manifest.id);
+        if (existing) {
+            throw new Error(`Plugin "${loaded.manifest.id}" is already registered`);
+        }
+        const registered = {
+            id: loaded.manifest.id,
+            manifest: loaded.manifest,
+            directory: loaded.directory,
+            provenance: loaded.provenance,
+            status: 'registered',
+            facades: [],
+            registeredAt: Date.now(),
+        };
+        this.plugins.set(registered.id, registered);
+        return registered;
+    }
+    /**
+     * Activate a plugin — builds facades from its manifest or JS module.
+     *
+     * If the plugin directory contains an `index.js` with a `createFacades` export,
+     * that function is called to build facades dynamically. Otherwise, facade stubs
+     * are created from the manifest's `facades` array (static ops with no-op handlers).
+     */
+    async activate(pluginId, ctx) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin)
+            throw new Error(`Plugin "${pluginId}" is not registered`);
+        if (plugin.status === 'active')
+            return plugin;
+        try {
+            // Try dynamic facade builder first
+            let facades = await this.tryLoadFacadeBuilder(plugin, ctx);
+            // Fall back to static manifest facades
+            if (!facades) {
+                facades = this.buildStaticFacades(plugin);
+            }
+            plugin.facades = facades;
+            plugin.status = 'active';
+            plugin.activatedAt = Date.now();
+            plugin.error = undefined;
+        }
+        catch (e) {
+            plugin.status = 'error';
+            plugin.error = e instanceof Error ? e.message : String(e);
+        }
+        return plugin;
+    }
+    /**
+     * Deactivate a plugin — removes its facades from the runtime.
+     */
+    deactivate(pluginId) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin)
+            return false;
+        plugin.status = 'deactivated';
+        plugin.facades = [];
+        return true;
+    }
+    /**
+     * Unregister a plugin completely.
+     */
+    unregister(pluginId) {
+        const plugin = this.plugins.get(pluginId);
+        if (!plugin)
+            return false;
+        if (plugin.status === 'active') {
+            this.deactivate(pluginId);
+        }
+        return this.plugins.delete(pluginId);
+    }
+    /**
+     * Get a registered plugin by ID.
+     */
+    get(pluginId) {
+        return this.plugins.get(pluginId);
+    }
+    /**
+     * List all registered plugins.
+     */
+    list() {
+        return Array.from(this.plugins.values());
+    }
+    /**
+     * Get all active facades from all active plugins.
+     */
+    getActiveFacades() {
+        const facades = [];
+        for (const plugin of this.plugins.values()) {
+            if (plugin.status === 'active') {
+                facades.push(...plugin.facades);
+            }
+        }
+        return facades;
+    }
+    /**
+     * Get all active ops (flattened from all active plugin facades).
+     */
+    getActiveOps() {
+        return this.getActiveFacades().flatMap((f) => f.ops);
+    }
+    // ─── Private ────────────────────────────────────────────────────────
+    /**
+     * Try to load a JS module with `createFacades` export from the plugin directory.
+     * Returns null if no module found or no export.
+     */
+    async tryLoadFacadeBuilder(plugin, ctx) {
+        const moduleFile = join(plugin.directory, 'index.js');
+        if (!existsSync(moduleFile)) {
+            return null;
+        }
+        try {
+            // Dynamic import of plugin's index.js
+            const mod = (await import(pathToFileURL(moduleFile).href));
+            if (typeof mod.createFacades === 'function') {
+                return mod.createFacades(ctx);
+            }
+            throw new Error(`Plugin module "${moduleFile}" must export createFacades(ctx)`);
+        }
+        catch (e) {
+            throw new Error(`Failed to load plugin module "${moduleFile}": ${e instanceof Error ? e.message : String(e)}`, { cause: e });
+        }
+    }
+    /**
+     * Build facade configs from the manifest's static facade definitions.
+     * These have no-op handlers — useful for schema discovery and documentation.
+     */
+    buildStaticFacades(plugin) {
+        return plugin.manifest.facades.map((f) => ({
+            name: f.name,
+            description: f.description,
+            ops: f.ops.map((op) => ({
+                name: op.name,
+                description: op.description,
+                auth: op.auth,
+                handler: async () => ({
+                    error: `Op "${op.name}" is a static plugin op — no handler implementation provided. Add an index.js with createFacades() to ${plugin.directory}`,
+                }),
+            })),
+        }));
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/plugins/plugin-registry.js.map

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

package/dist/plugins/types.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Plugin System — Types & Manifest Schema
+ *
+ * A plugin is a directory containing a `soleri-plugin.json` manifest
+ * and optionally additional intelligence data. Plugins register
+ * OpDefinition[] (facades) dynamically without re-scaffolding.
+ */
+import { z } from 'zod';
+import type { FacadeConfig } from '../facades/types.js';
+export declare const pluginManifestSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    /** Domain this plugin provides knowledge/ops for */
+    domain: z.ZodOptional<z.ZodString>;
+    /** Plugin IDs this plugin depends on (must be loaded first) */
+    dependencies: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    /** Facade definitions — each becomes an MCP tool */
+    facades: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        ops: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            auth: z.ZodDefault<z.ZodOptional<z.ZodEnum<["read", "write", "admin"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            description: string;
+            auth: "write" | "read" | "admin";
+        }, {
+            name: string;
+            description?: string | undefined;
+            auth?: "write" | "read" | "admin" | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        ops: {
+            name: string;
+            description: string;
+            auth: "write" | "read" | "admin";
+        }[];
+    }, {
+        name: string;
+        ops: {
+            name: string;
+            description?: string | undefined;
+            auth?: "write" | "read" | "admin" | undefined;
+        }[];
+        description?: string | undefined;
+    }>, "many">>>;
+    /** Intelligence entries to seed into the vault */
+    intelligence: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodString;
+        domain: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        severity: z.ZodOptional<z.ZodEnum<["critical", "warning", "suggestion"]>>;
+        description: z.ZodString;
+        tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        type: string;
+        description: string;
+        title: string;
+        tags: string[];
+        domain?: string | undefined;
+        severity?: "critical" | "warning" | "suggestion" | undefined;
+    }, {
+        id: string;
+        type: string;
+        description: string;
+        title: string;
+        domain?: string | undefined;
+        severity?: "critical" | "warning" | "suggestion" | undefined;
+        tags?: string[] | undefined;
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name: string;
+    description: string;
+    version: string;
+    dependencies: string[];
+    facades: {
+        name: string;
+        description: string;
+        ops: {
+            name: string;
+            description: string;
+            auth: "write" | "read" | "admin";
+        }[];
+    }[];
+    intelligence: {
+        id: string;
+        type: string;
+        description: string;
+        title: string;
+        tags: string[];
+        domain?: string | undefined;
+        severity?: "critical" | "warning" | "suggestion" | undefined;
+    }[];
+    domain?: string | undefined;
+}, {
+    id: string;
+    name: string;
+    version: string;
+    description?: string | undefined;
+    domain?: string | undefined;
+    dependencies?: string[] | undefined;
+    facades?: {
+        name: string;
+        ops: {
+            name: string;
+            description?: string | undefined;
+            auth?: "write" | "read" | "admin" | undefined;
+        }[];
+        description?: string | undefined;
+    }[] | undefined;
+    intelligence?: {
+        id: string;
+        type: string;
+        description: string;
+        title: string;
+        domain?: string | undefined;
+        severity?: "critical" | "warning" | "suggestion" | undefined;
+        tags?: string[] | undefined;
+    }[] | undefined;
+}>;
+export type PluginManifest = z.infer<typeof pluginManifestSchema>;
+export type PluginStatus = 'registered' | 'active' | 'error' | 'deactivated';
+export type PluginProvenance = 'global' | 'project' | 'custom';
+/**
+ * A loaded plugin — manifest validated, ready for activation.
+ */
+export interface LoadedPlugin {
+    manifest: PluginManifest;
+    directory: string;
+    provenance: PluginProvenance;
+}
+/**
+ * A registered plugin in the runtime — tracks lifecycle state.
+ */
+export interface RegisteredPlugin {
+    id: string;
+    manifest: PluginManifest;
+    directory: string;
+    provenance: PluginProvenance;
+    status: PluginStatus;
+    error?: string;
+    facades: FacadeConfig[];
+    activatedAt?: number;
+    registeredAt: number;
+}
+/**
+ * Plugin facade builder — plugins provide this function to create ops
+ * that have access to the agent runtime.
+ *
+ * Plugin JS modules export: `export function createFacades(ctx): FacadeConfig[]`
+ */
+export type PluginFacadeBuilder = (ctx: PluginContext) => FacadeConfig[];
+/**
+ * Context passed to plugin facade builders during activation.
+ */
+export interface PluginContext {
+    /** The agent runtime — full access to vault, brain, planner, etc. */
+    runtime: unknown;
+    /** The plugin's own manifest */
+    manifest: PluginManifest;
+    /** The plugin's directory on disk */
+    directory: string;
+}
+export interface LoadResult {
+    loaded: LoadedPlugin[];
+    errors: Array<{
+        directory: string;
+        error: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plugins/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMxD,eAAO,MAAM,oBAAoB;;;;;IAK/B,oDAAoD;;IAEpD,+DAA+D;;IAE/D,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiBpD,kDAAkD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAelD,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,CAAC;AAC7E,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,aAAa,KAAK,YAAY,EAAE,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,QAAQ,EAAE,cAAc,CAAC;IACzB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrD"}

package/dist/plugins/types.js

@@ -0,0 +1,48 @@
+/**
+ * Plugin System — Types & Manifest Schema
+ *
+ * A plugin is a directory containing a `soleri-plugin.json` manifest
+ * and optionally additional intelligence data. Plugins register
+ * OpDefinition[] (facades) dynamically without re-scaffolding.
+ */
+import { z } from 'zod';
+// =============================================================================
+// MANIFEST SCHEMA (validated at load time)
+// =============================================================================
+export const pluginManifestSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/, 'Plugin ID must be lowercase alphanumeric with hyphens'),
+    name: z.string().min(1),
+    version: z.string().regex(/^\d+\.\d+\.\d+$/, 'Version must be semver (x.y.z)'),
+    description: z.string().optional().default(''),
+    /** Domain this plugin provides knowledge/ops for */
+    domain: z.string().optional(),
+    /** Plugin IDs this plugin depends on (must be loaded first) */
+    dependencies: z.array(z.string()).optional().default([]),
+    /** Facade definitions — each becomes an MCP tool */
+    facades: z
+        .array(z.object({
+        name: z.string(),
+        description: z.string().optional().default(''),
+        ops: z.array(z.object({
+            name: z.string(),
+            description: z.string().optional().default(''),
+            auth: z.enum(['read', 'write', 'admin']).optional().default('read'),
+        })),
+    }))
+        .optional()
+        .default([]),
+    /** Intelligence entries to seed into the vault */
+    intelligence: z
+        .array(z.object({
+        id: z.string(),
+        type: z.string(),
+        domain: z.string().optional(),
+        title: z.string(),
+        severity: z.enum(['critical', 'warning', 'suggestion']).optional(),
+        description: z.string(),
+        tags: z.array(z.string()).optional().default([]),
+    }))
+        .optional()
+        .default([]),
+});
+//# sourceMappingURL=types.js.map

package/dist/plugins/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/plugins/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,gFAAgF;AAChF,2CAA2C;AAC3C,gFAAgF;AAEhF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,uDAAuD,CAAC;IAC7F,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,EAAE,gCAAgC,CAAC;IAC9E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC9C,oDAAoD;IACpD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,+DAA+D;IAC/D,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD,oDAAoD;IACpD,OAAO,EAAE,CAAC;SACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9C,GAAG,EAAE,CAAC,CAAC,KAAK,CACV,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9C,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;SACpE,CAAC,CACH;KACF,CAAC,CACH;SACA,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;IACd,kDAAkD;IAClD,YAAY,EAAE,CAAC;SACZ,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACjD,CAAC,CACH;SACA,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC"}

package/dist/runtime/admin-extra-ops.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"admin-extra-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/admin-extra-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsB/C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAuoBzE"}
+{"version":3,"file":"admin-extra-ops.d.ts","sourceRoot":"","sources":["../../src/runtime/admin-extra-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsB/C;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,EAAE,CAg0BzE"}