@x12i/memorix-service 3.0.6 → 3.1.0

package/dist/mongo-metadata-store.js.map

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

package/dist/openapi/openapi.json

@@ -433,6 +433,24 @@
                       "type": "object",
                       "additionalProperties": true,
                       "nullable": true
+                    },
+                    "lineage": {
+                      "type": "object",
+                      "nullable": true,
+                      "description": "Latest install ledger entry for agentId (magitCommit when METADATA_MAGIT=1)",
+                      "properties": {
+                        "checksum": {
+                          "type": "string"
+                        },
+                        "installedAt": {
+                          "type": "string",
+                          "format": "date-time"
+                        },
+                        "magitCommit": {
+                          "type": "string",
+                          "nullable": true
+                        }
+                      }
                     }
                   }
                 }
@@ -814,6 +832,83 @@
         }
       }
     },
+    "/api/metadata/topology": {
+      "get": {
+        "operationId": "metadataTopology",
+        "summary": "Projected concrete metadata topology (OT↔OT relationships, feeds, pipeline wiring)",
+        "tags": [
+          "Metadata"
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/XMemorixOrgId"
+          },
+          {
+            "$ref": "#/components/parameters/XMemorixAgentIds"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Topology nodes and edges",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": [
+                    "scope",
+                    "ok",
+                    "nodes",
+                    "edges"
+                  ],
+                  "properties": {
+                    "scope": {
+                      "$ref": "#/components/schemas/MemorixScope"
+                    },
+                    "ok": {
+                      "type": "boolean"
+                    },
+                    "nodes": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    },
+                    "edges": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    },
+                    "issues": {
+                      "type": "array",
+                      "items": {
+                        "type": "object",
+                        "additionalProperties": true
+                      }
+                    },
+                    "note": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request / validation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/metadata/validate": {
       "post": {
         "operationId": "metadataValidate",
@@ -1041,6 +1136,18 @@
                   },
                   "reinstall": {
                     "type": "boolean"
+                  },
+                  "versionMessage": {
+                    "type": "string",
+                    "description": "Optional Magit save-version message when Magit is enabled (default on with durable Mongo; METADATA_MAGIT=0 disables); defaults to \"Install {agentId}\""
+                  },
+                  "commit": {
+                    "type": "string",
+                    "description": "Install pack reconstructed from this Magit commit (requires Magit)"
+                  },
+                  "proposalId": {
+                    "type": "string",
+                    "description": "When set with commit, ledger source is proposal-install and message includes the proposal id"
                   }
                 }
               },
@@ -1053,10 +1160,178 @@
         }
       }
     },
+    "/api/metadata/proposals/{id}/stage": {
+      "post": {
+        "operationId": "metadataStageProposal",
+        "summary": "Stage an intelligence proposal as a pack version (not live)",
+        "description": "Merges the proposal draft into the agent pack, saves a Magit version (message proposal:<id>), and validates. Never installs. Requires Magit.",
+        "tags": ["Metadata"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" },
+            "description": "Proposal id"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "agentId": { "type": "string" },
+                  "proposal": {
+                    "type": "object",
+                    "description": "Optional inline proposal body when not loading from the intelligence store",
+                    "properties": {
+                      "proposalId": { "type": "string" },
+                      "metadataKind": { "type": "string" },
+                      "metadataId": { "type": "string" },
+                      "draft": {},
+                      "scope": {
+                        "type": "object",
+                        "properties": {
+                          "agentIds": {
+                            "type": "array",
+                            "items": { "type": "string" }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Staged version (installed: false)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "required": ["scope", "commit", "installed"],
+                  "properties": {
+                    "scope": { "$ref": "#/components/schemas/MemorixScope" },
+                    "proposalId": { "type": "string" },
+                    "agentId": { "type": "string" },
+                    "commit": { "type": "string" },
+                    "checksum": { "type": "string" },
+                    "pack": { "$ref": "#/components/schemas/MetadataPack" },
+                    "validation": {},
+                    "installed": { "type": "boolean", "enum": [false] },
+                    "note": { "type": "string" }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad request",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }
+              }
+            }
+          },
+          "503": {
+            "description": "Magit unavailable",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/api/metadata/install/bundle": {
+      "post": {
+        "operationId": "metadataInstallBundle",
+        "summary": "Atomic multi-agent install from one Magit commit",
+        "description": "Installs the same commit for each agentId. On any failure, restores prior packs for agents already applied. Requires Magit.",
+        "tags": ["Metadata"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["confirm", "commit"],
+                "properties": {
+                  "confirm": { "type": "boolean", "enum": [true] },
+                  "commit": { "type": "string" },
+                  "agentIds": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "minItems": 1
+                  },
+                  "message": { "type": "string" },
+                  "release": {
+                    "type": "string",
+                    "description": "Optional named release stamp (magitRelease)"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Bundle install result",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "scope": { "$ref": "#/components/schemas/MemorixScope" },
+                    "installed": { "type": "boolean" },
+                    "rolledBack": { "type": "boolean" },
+                    "commit": { "type": "string" },
+                    "ledgerEntries": { "type": "array", "items": {} },
+                    "restoredAgentIds": {
+                      "type": "array",
+                      "items": { "type": "string" }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Validation / rolled back failure",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }
+              }
+            }
+          },
+          "503": {
+            "description": "Magit unavailable",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/metadata/publish": {
       "post": {
         "operationId": "metadataPublish",
-        "summary": "Explicit publish (confirm required)",
+        "summary": "Publish a named pack release (Magit apply to live)",
+        "description": "Requires Magit (default on with durable Mongo; METADATA_MAGIT=0 disables). Applies commit to live metadata for one or more agents atomically and records magitRelease on the ledger. On failure, restores prior packs for already-applied agents.",
         "tags": [
           "Metadata"
         ],
@@ -1150,6 +1425,27 @@
                     "enum": [
                       true
                     ]
+                  },
+                  "release": {
+                    "type": "string"
+                  },
+                  "commit": {
+                    "type": "string"
+                  },
+                  "agentIds": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  },
+                  "agentId": {
+                    "type": "string"
+                  },
+                  "message": {
+                    "type": "string"
+                  },
+                  "planHash": {
+                    "type": "string"
                   }
                 }
               }
@@ -1158,11 +1454,133 @@
         }
       }
     },
+    "/api/metadata/publish/plan": {
+      "post": {
+        "operationId": "metadataPublishPlan",
+        "summary": "Read-only publish plan for a named release",
+        "tags": ["Metadata"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["release", "commit"],
+                "properties": {
+                  "release": { "type": "string" },
+                  "commit": { "type": "string" },
+                  "agentIds": { "type": "array", "items": { "type": "string" } },
+                  "agentId": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": { "description": "Publish plan" },
+          "503": { "description": "Magit unavailable" }
+        }
+      }
+    },
+    "/api/metadata/rollback": {
+      "post": {
+        "operationId": "metadataRollback",
+        "summary": "Restore agent pack to a prior Magit commit",
+        "tags": ["Metadata"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["confirm", "commit"],
+                "properties": {
+                  "confirm": { "type": "boolean", "enum": [true] },
+                  "commit": { "type": "string" },
+                  "agentId": { "type": "string" },
+                  "message": { "type": "string" }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": { "description": "Restore result" },
+          "400": { "description": "Validation / confirmation required" },
+          "503": { "description": "Magit unavailable" }
+        }
+      }
+    },
+    "/api/metadata/diff": {
+      "post": {
+        "operationId": "metadataDiff",
+        "summary": "Diff pack versions (kind/id rows)",
+        "tags": ["Metadata"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "required": ["from", "to"],
+                "properties": {
+                  "agentId": { "type": "string" },
+                  "from": { "type": "string", "description": "commit | live | HEAD" },
+                  "to": { "type": "string", "description": "commit | live | HEAD" }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": { "description": "Diff rows" },
+          "503": { "description": "Magit unavailable" }
+        }
+      }
+    },
+    "/api/metadata/versions/{commit}": {
+      "get": {
+        "operationId": "metadataPackAtCommit",
+        "summary": "Pack reconstructed at a Magit commit",
+        "tags": ["Metadata"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          {
+            "name": "commit",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" }
+          },
+          {
+            "name": "agentId",
+            "in": "query",
+            "schema": { "type": "string" }
+          }
+        ],
+        "responses": {
+          "200": { "description": "Pack at commit" },
+          "503": { "description": "Magit unavailable" }
+        }
+      }
+    },
     "/api/metadata/versions": {
       "post": {
         "operationId": "metadataSaveVersion",
         "summary": "Save a pack version (not live; Magit-backed when METADATA_MAGIT=1)",
-        "description": "Records a pack snapshot for history. Does not install. Requires METADATA_MAGIT=1 and org isolation.",
+        "description": "Records a pack snapshot for history. Does not install. Requires METADATA_MAGIT=1 and a durable Mongo connection.",
         "tags": [
           "Metadata"
         ],
@@ -1269,7 +1687,7 @@
       "get": {
         "operationId": "metadataListVersions",
         "summary": "List saved pack versions for an agent",
-        "description": "Requires METADATA_MAGIT=1 and org isolation.",
+        "description": "Requires METADATA_MAGIT=1 and a durable Mongo connection.",
         "tags": [
           "Metadata"
         ],
@@ -5318,6 +5736,57 @@
         }
       }
     },
+    "/api/intelligence/proposals/{id}": {
+      "get": {
+        "operationId": "intelligenceGetProposal",
+        "summary": "Get one intelligence proposal by id",
+        "description": "Returns the full proposal body from the durable artifact store. Stage via POST /api/metadata/proposals/{id}/stage — never auto-installs.",
+        "tags": ["Intelligence"],
+        "parameters": [
+          { "$ref": "#/components/parameters/XMemorixOrgId" },
+          { "$ref": "#/components/parameters/XMemorixAgentIds" },
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": { "type": "string" }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Proposal body",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "scope": { "$ref": "#/components/schemas/MemorixScope" },
+                    "proposal": {},
+                    "note": { "type": "string" }
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not found",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }
+              }
+            }
+          },
+          "503": {
+            "description": "Durable store required",
+            "content": {
+              "application/json": {
+                "schema": { "$ref": "#/components/schemas/ErrorEnvelope" }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/intelligence/compare": {
       "post": {
         "operationId": "intelligenceCompare",

package/dist/org-sources.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Helpers for org-scoped runtime sources vs Magit/pack sources.
+ */
+import type { MetadataPack, SourceDefinition } from "@x12i/memorix-metadata";
+/** True for user/org folder sources that must never enter Magit packs. */
+export declare function isOrgRuntimeFolderSource(entry: {
+    id?: string;
+    kind?: string;
+    connectorRef?: string;
+} | null | undefined): boolean;
+/** Strip org folder sources from a metadata pack (Magit / disk install hygiene). */
+export declare function stripOrgRuntimeSourcesFromPack<T extends MetadataPack>(pack: T): T;
+export declare function asSourceDefinition(raw: Record<string, unknown>, sourceId: string): SourceDefinition;
+//# sourceMappingURL=org-sources.d.ts.map

package/dist/org-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-sources.d.ts","sourceRoot":"","sources":["../src/org-sources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,0EAA0E;AAC1E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAC9E,OAAO,CAUT;AAED,oFAAoF;AACpF,wBAAgB,8BAA8B,CAAC,CAAC,SAAS,YAAY,EACnE,IAAI,EAAE,CAAC,GACN,CAAC,CAKH;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAOlB"}

package/dist/org-sources.js

@@ -0,0 +1,31 @@
+/**
+ * Helpers for org-scoped runtime sources vs Magit/pack sources.
+ */
+/** True for user/org folder sources that must never enter Magit packs. */
+export function isOrgRuntimeFolderSource(entry) {
+    if (!entry || typeof entry !== "object")
+        return false;
+    const kind = String(entry.kind ?? "");
+    const connectorRef = String(entry.connectorRef ?? "");
+    const id = String(entry.id ?? "");
+    return (kind === "knowx-folder" ||
+        connectorRef === "knowx-folder" ||
+        /^src_/i.test(id));
+}
+/** Strip org folder sources from a metadata pack (Magit / disk install hygiene). */
+export function stripOrgRuntimeSourcesFromPack(pack) {
+    const sources = Array.isArray(pack.sources) ? pack.sources : [];
+    const kept = sources.filter((s) => !isOrgRuntimeFolderSource(s));
+    if (kept.length === sources.length)
+        return pack;
+    return { ...pack, sources: kept };
+}
+export function asSourceDefinition(raw, sourceId) {
+    return {
+        ...raw,
+        id: String(raw.id ?? sourceId).trim() || sourceId,
+        name: String(raw.name ?? sourceId),
+        kind: String(raw.kind ?? "knowx-folder"),
+    };
+}
+//# sourceMappingURL=org-sources.js.map

package/dist/org-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-sources.js","sourceRoot":"","sources":["../src/org-sources.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,0EAA0E;AAC1E,MAAM,UAAU,wBAAwB,CACtC,KAA+E;IAE/E,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAClC,OAAO,CACL,IAAI,KAAK,cAAc;QACvB,YAAY,KAAK,cAAc;QAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAClB,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,8BAA8B,CAC5C,IAAO;IAEP,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,GAA4B,EAC5B,QAAgB;IAEhB,OAAO;QACL,GAAI,GAAwB;QAC5B,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,QAAQ;QACjD,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,QAAQ,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,cAAc,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/pipeline-compile.d.ts

@@ -6,11 +6,43 @@ export type ServiceDefSlice = {
     id?: string;
     serviceId?: string;
     memorixAccess?: unknown;
+    /** AI-services/v1 binding (type + item); when set, compile stamps FR invoke config. */
+    aiService?: {
+        aiServiceType?: string;
+        itemId?: string;
+        endpointEnv?: string;
+        endpoint?: string;
+    };
     invocation?: {
         operation?: string;
+        /** Env var name holding a per-service worker base URL (e.g. KNOWX_EXTRACT_WORKER_URL). */
+        endpointEnv?: string;
+        /** Alias under invocation for pack authors. */
+        aiServiceType?: string;
+        itemId?: string;
     };
 };
 export declare function resolveKnowxWorkerBaseUrl(): string;
+/**
+ * Explicit test-only switch for the APS AI Services Simulator.
+ * Default OFF — production / normal local stack always uses the real KnowX worker
+ * for knowx-extract. Set KNOWX_AI_SIM=1 (or true/on/yes) to enable routing.
+ */
+export declare function isKnowxAiSimEnabled(): boolean;
+/**
+ * AI-sim base URL for knowx-extract — only when {@link isKnowxAiSimEnabled}.
+ * Optional override: KNOWX_EXTRACT_WORKER_URL / MEMORIX_KNOWX_EXTRACT_WORKER_URL.
+ */
+export declare function resolveKnowxExtractWorkerUrl(): string | undefined;
+/**
+ * Resolve analyze-step worker endpoint.
+ * knowx-extract → APS AI sim only when KNOWX_AI_SIM=1 (test-only); otherwise
+ * all services use the KnowX control-plane worker.
+ */
+export declare function resolveKnowxServiceEndpoint(serviceId: string, opts?: {
+    workerBaseUrl?: string;
+    endpointEnv?: string;
+}): string;
 export declare function compileAuthoringPipeline(input: unknown, opts?: {
     knownServiceIds?: Set<string>;
     workerBaseUrl?: string;

package/dist/pipeline-compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-compile.d.ts","sourceRoot":"","sources":["../src/pipeline-compile.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,2BAA2B,CAAC;AA8BnC,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC,CAAC;AAEF,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;IACL,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC,GACA,kBAAkB,CAuEpB"}
+{"version":3,"file":"pipeline-compile.d.ts","sourceRoot":"","sources":["../src/pipeline-compile.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,2BAA2B,CAAC;AAmCnC,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uFAAuF;IACvF,SAAS,CAAC,EAAE;QACV,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,0FAA0F;QAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,+CAA+C;QAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,wBAAgB,yBAAyB,IAAI,MAAM,CAMlD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAID;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,SAAS,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IACL,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,MAAM,CAiBR;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE;IACL,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;CACjC,GACA,kBAAkB,CAiJpB"}