@frengki0707/google-cloud-clone 1.33.0

package/lib/telemetry/engagement.d.mts

@@ -0,0 +1,35 @@
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { Telemetry } from '../metrics.mjs';
+import '@opentelemetry/api';
+
+/**
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class EngagementTelemetry implements Telemetry {
+    /**
+     * Wraps the declared metrics in a Genkit-specific, internal namespace.
+     */
+    private _N;
+    private feedbackCounter;
+    private acceptanceCounter;
+    tick(span: ReadableSpan, logInputAndOutput: boolean, projectId?: string): void;
+    private writeUserFeedback;
+    private writeUserAcceptance;
+    private extractTraceName;
+}
+declare const engagementTelemetry: EngagementTelemetry;
+
+export { engagementTelemetry };

package/lib/telemetry/engagement.d.ts

@@ -0,0 +1,35 @@
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { Telemetry } from '../metrics.js';
+import '@opentelemetry/api';
+
+/**
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class EngagementTelemetry implements Telemetry {
+    /**
+     * Wraps the declared metrics in a Genkit-specific, internal namespace.
+     */
+    private _N;
+    private feedbackCounter;
+    private acceptanceCounter;
+    tick(span: ReadableSpan, logInputAndOutput: boolean, projectId?: string): void;
+    private writeUserFeedback;
+    private writeUserAcceptance;
+    private extractTraceName;
+}
+declare const engagementTelemetry: EngagementTelemetry;
+
+export { engagementTelemetry };

package/lib/telemetry/engagement.js

@@ -0,0 +1,106 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var engagement_exports = {};
+__export(engagement_exports, {
+  engagementTelemetry: () => engagementTelemetry
+});
+module.exports = __toCommonJS(engagement_exports);
+var import_api = require("@opentelemetry/api");
+var import_genkit = require("genkit");
+var import_logging = require("genkit/logging");
+var import_metrics = require("../metrics.js");
+var import_utils = require("../utils.js");
+class EngagementTelemetry {
+  /**
+   * Wraps the declared metrics in a Genkit-specific, internal namespace.
+   */
+  _N = import_metrics.internalMetricNamespaceWrap.bind(null, "engagement");
+  feedbackCounter = new import_metrics.MetricCounter(this._N("feedback"), {
+    description: "Counts calls to genkit flows.",
+    valueType: import_api.ValueType.INT
+  });
+  acceptanceCounter = new import_metrics.MetricCounter(this._N("acceptance"), {
+    description: "Tracks unique flow paths per flow.",
+    valueType: import_api.ValueType.INT
+  });
+  tick(span, logInputAndOutput, projectId) {
+    const subtype = span.attributes["genkit:metadata:subtype"];
+    if (subtype === "userFeedback") {
+      this.writeUserFeedback(span, projectId);
+      return;
+    }
+    if (subtype === "userAcceptance") {
+      this.writeUserAcceptance(span, projectId);
+      return;
+    }
+    import_logging.logger.warn(`Unknown user engagement subtype: ${subtype}`);
+  }
+  writeUserFeedback(span, projectId) {
+    const attributes = span.attributes;
+    const name = this.extractTraceName(attributes);
+    const dimensions = {
+      name,
+      value: attributes["genkit:metadata:feedbackValue"],
+      hasText: !!attributes["genkit:metadata:textFeedback"],
+      source: "ts",
+      sourceVersion: import_genkit.GENKIT_VERSION
+    };
+    this.feedbackCounter.add(1, dimensions);
+    const metadata = {
+      ...(0, import_utils.createCommonLogAttributes)(span, projectId),
+      feedbackValue: attributes["genkit:metadata:feedbackValue"]
+    };
+    if (attributes["genkit:metadata:textFeedback"]) {
+      metadata["textFeedback"] = (0, import_utils.truncate)(
+        attributes["genkit:metadata:textFeedback"]
+      );
+    }
+    import_logging.logger.logStructured(`UserFeedback[${name}]`, metadata);
+  }
+  writeUserAcceptance(span, projectId) {
+    const attributes = span.attributes;
+    const name = this.extractTraceName(attributes);
+    const dimensions = {
+      name,
+      value: attributes["genkit:metadata:acceptanceValue"],
+      source: "ts",
+      sourceVersion: import_genkit.GENKIT_VERSION
+    };
+    this.acceptanceCounter.add(1, dimensions);
+    const metadata = {
+      ...(0, import_utils.createCommonLogAttributes)(span, projectId),
+      acceptanceValue: attributes["genkit:metadata:acceptanceValue"]
+    };
+    import_logging.logger.logStructured(`UserAcceptance[${name}]`, metadata);
+  }
+  extractTraceName(attributes) {
+    const path = attributes["genkit:path"];
+    if (!path || path === "<unknown>") {
+      return "<unknown>";
+    }
+    const name = path.match("/{(.+)}+");
+    return name ? name[1] : "<unknown>";
+  }
+}
+const engagementTelemetry = new EngagementTelemetry();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  engagementTelemetry
+});
+//# sourceMappingURL=engagement.js.map

package/lib/telemetry/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/engagement.ts"],"sourcesContent":["/**\n * Copyright 2024 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ValueType, type Attributes } from '@opentelemetry/api';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { GENKIT_VERSION } from 'genkit';\nimport { logger } from 'genkit/logging';\nimport {\n  MetricCounter,\n  internalMetricNamespaceWrap,\n  type Telemetry,\n} from '../metrics.js';\nimport { createCommonLogAttributes, truncate } from '../utils.js';\n\nclass EngagementTelemetry implements Telemetry {\n  /**\n   * Wraps the declared metrics in a Genkit-specific, internal namespace.\n   */\n  private _N = internalMetricNamespaceWrap.bind(null, 'engagement');\n\n  private feedbackCounter = new MetricCounter(this._N('feedback'), {\n    description: 'Counts calls to genkit flows.',\n    valueType: ValueType.INT,\n  });\n\n  private acceptanceCounter = new MetricCounter(this._N('acceptance'), {\n    description: 'Tracks unique flow paths per flow.',\n    valueType: ValueType.INT,\n  });\n\n  tick(\n    span: ReadableSpan,\n    logInputAndOutput: boolean,\n    projectId?: string\n  ): void {\n    const subtype = span.attributes['genkit:metadata:subtype'] as string;\n\n    if (subtype === 'userFeedback') {\n      this.writeUserFeedback(span, projectId);\n      return;\n    }\n\n    if (subtype === 'userAcceptance') {\n      this.writeUserAcceptance(span, projectId);\n      return;\n    }\n\n    logger.warn(`Unknown user engagement subtype: ${subtype}`);\n  }\n\n  private writeUserFeedback(span: ReadableSpan, projectId?: string) {\n    const attributes = span.attributes;\n    const name = this.extractTraceName(attributes);\n\n    const dimensions = {\n      name,\n      value: attributes['genkit:metadata:feedbackValue'],\n      hasText: !!attributes['genkit:metadata:textFeedback'],\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n    };\n    this.feedbackCounter.add(1, dimensions);\n\n    const metadata = {\n      ...createCommonLogAttributes(span, projectId),\n      feedbackValue: attributes['genkit:metadata:feedbackValue'],\n    };\n    if (attributes['genkit:metadata:textFeedback']) {\n      metadata['textFeedback'] = truncate(\n        attributes['genkit:metadata:textFeedback'] as string\n      );\n    }\n    logger.logStructured(`UserFeedback[${name}]`, metadata);\n  }\n\n  private writeUserAcceptance(span: ReadableSpan, projectId?: string) {\n    const attributes = span.attributes;\n    const name = this.extractTraceName(attributes);\n\n    const dimensions = {\n      name,\n      value: attributes['genkit:metadata:acceptanceValue'],\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n    };\n    this.acceptanceCounter.add(1, dimensions);\n\n    const metadata = {\n      ...createCommonLogAttributes(span, projectId),\n      acceptanceValue: attributes['genkit:metadata:acceptanceValue'],\n    };\n    logger.logStructured(`UserAcceptance[${name}]`, metadata);\n  }\n\n  private extractTraceName(attributes: Attributes) {\n    const path = attributes['genkit:path'] as string;\n    if (!path || path === '<unknown>') {\n      return '<unknown>';\n    }\n\n    const name = path.match('/{(.+)}+');\n    return name ? name[1] : '<unknown>';\n  }\n}\n\nconst engagementTelemetry = new EngagementTelemetry();\nexport { engagementTelemetry };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBA,iBAA2C;AAE3C,oBAA+B;AAC/B,qBAAuB;AACvB,qBAIO;AACP,mBAAoD;AAEpD,MAAM,oBAAyC;AAAA;AAAA;AAAA;AAAA,EAIrC,KAAK,2CAA4B,KAAK,MAAM,YAAY;AAAA,EAExD,kBAAkB,IAAI,6BAAc,KAAK,GAAG,UAAU,GAAG;AAAA,IAC/D,aAAa;AAAA,IACb,WAAW,qBAAU;AAAA,EACvB,CAAC;AAAA,EAEO,oBAAoB,IAAI,6BAAc,KAAK,GAAG,YAAY,GAAG;AAAA,IACnE,aAAa;AAAA,IACb,WAAW,qBAAU;AAAA,EACvB,CAAC;AAAA,EAED,KACE,MACA,mBACA,WACM;AACN,UAAM,UAAU,KAAK,WAAW,yBAAyB;AAEzD,QAAI,YAAY,gBAAgB;AAC9B,WAAK,kBAAkB,MAAM,SAAS;AACtC;AAAA,IACF;AAEA,QAAI,YAAY,kBAAkB;AAChC,WAAK,oBAAoB,MAAM,SAAS;AACxC;AAAA,IACF;AAEA,0BAAO,KAAK,oCAAoC,OAAO,EAAE;AAAA,EAC3D;AAAA,EAEQ,kBAAkB,MAAoB,WAAoB;AAChE,UAAM,aAAa,KAAK;AACxB,UAAM,OAAO,KAAK,iBAAiB,UAAU;AAE7C,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,OAAO,WAAW,+BAA+B;AAAA,MACjD,SAAS,CAAC,CAAC,WAAW,8BAA8B;AAAA,MACpD,QAAQ;AAAA,MACR,eAAe;AAAA,IACjB;AACA,SAAK,gBAAgB,IAAI,GAAG,UAAU;AAEtC,UAAM,WAAW;AAAA,MACf,OAAG,wCAA0B,MAAM,SAAS;AAAA,MAC5C,eAAe,WAAW,+BAA+B;AAAA,IAC3D;AACA,QAAI,WAAW,8BAA8B,GAAG;AAC9C,eAAS,cAAc,QAAI;AAAA,QACzB,WAAW,8BAA8B;AAAA,MAC3C;AAAA,IACF;AACA,0BAAO,cAAc,gBAAgB,IAAI,KAAK,QAAQ;AAAA,EACxD;AAAA,EAEQ,oBAAoB,MAAoB,WAAoB;AAClE,UAAM,aAAa,KAAK;AACxB,UAAM,OAAO,KAAK,iBAAiB,UAAU;AAE7C,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,OAAO,WAAW,iCAAiC;AAAA,MACnD,QAAQ;AAAA,MACR,eAAe;AAAA,IACjB;AACA,SAAK,kBAAkB,IAAI,GAAG,UAAU;AAExC,UAAM,WAAW;AAAA,MACf,OAAG,wCAA0B,MAAM,SAAS;AAAA,MAC5C,iBAAiB,WAAW,iCAAiC;AAAA,IAC/D;AACA,0BAAO,cAAc,kBAAkB,IAAI,KAAK,QAAQ;AAAA,EAC1D;AAAA,EAEQ,iBAAiB,YAAwB;AAC/C,UAAM,OAAO,WAAW,aAAa;AACrC,QAAI,CAAC,QAAQ,SAAS,aAAa;AACjC,aAAO;AAAA,IACT;AAEA,UAAM,OAAO,KAAK,MAAM,UAAU;AAClC,WAAO,OAAO,KAAK,CAAC,IAAI;AAAA,EAC1B;AACF;AAEA,MAAM,sBAAsB,IAAI,oBAAoB;","names":[]}

package/lib/telemetry/engagement.mjs

@@ -0,0 +1,85 @@
+import { ValueType } from "@opentelemetry/api";
+import { GENKIT_VERSION } from "genkit";
+import { logger } from "genkit/logging";
+import {
+  MetricCounter,
+  internalMetricNamespaceWrap
+} from "../metrics.js";
+import { createCommonLogAttributes, truncate } from "../utils.js";
+class EngagementTelemetry {
+  /**
+   * Wraps the declared metrics in a Genkit-specific, internal namespace.
+   */
+  _N = internalMetricNamespaceWrap.bind(null, "engagement");
+  feedbackCounter = new MetricCounter(this._N("feedback"), {
+    description: "Counts calls to genkit flows.",
+    valueType: ValueType.INT
+  });
+  acceptanceCounter = new MetricCounter(this._N("acceptance"), {
+    description: "Tracks unique flow paths per flow.",
+    valueType: ValueType.INT
+  });
+  tick(span, logInputAndOutput, projectId) {
+    const subtype = span.attributes["genkit:metadata:subtype"];
+    if (subtype === "userFeedback") {
+      this.writeUserFeedback(span, projectId);
+      return;
+    }
+    if (subtype === "userAcceptance") {
+      this.writeUserAcceptance(span, projectId);
+      return;
+    }
+    logger.warn(`Unknown user engagement subtype: ${subtype}`);
+  }
+  writeUserFeedback(span, projectId) {
+    const attributes = span.attributes;
+    const name = this.extractTraceName(attributes);
+    const dimensions = {
+      name,
+      value: attributes["genkit:metadata:feedbackValue"],
+      hasText: !!attributes["genkit:metadata:textFeedback"],
+      source: "ts",
+      sourceVersion: GENKIT_VERSION
+    };
+    this.feedbackCounter.add(1, dimensions);
+    const metadata = {
+      ...createCommonLogAttributes(span, projectId),
+      feedbackValue: attributes["genkit:metadata:feedbackValue"]
+    };
+    if (attributes["genkit:metadata:textFeedback"]) {
+      metadata["textFeedback"] = truncate(
+        attributes["genkit:metadata:textFeedback"]
+      );
+    }
+    logger.logStructured(`UserFeedback[${name}]`, metadata);
+  }
+  writeUserAcceptance(span, projectId) {
+    const attributes = span.attributes;
+    const name = this.extractTraceName(attributes);
+    const dimensions = {
+      name,
+      value: attributes["genkit:metadata:acceptanceValue"],
+      source: "ts",
+      sourceVersion: GENKIT_VERSION
+    };
+    this.acceptanceCounter.add(1, dimensions);
+    const metadata = {
+      ...createCommonLogAttributes(span, projectId),
+      acceptanceValue: attributes["genkit:metadata:acceptanceValue"]
+    };
+    logger.logStructured(`UserAcceptance[${name}]`, metadata);
+  }
+  extractTraceName(attributes) {
+    const path = attributes["genkit:path"];
+    if (!path || path === "<unknown>") {
+      return "<unknown>";
+    }
+    const name = path.match("/{(.+)}+");
+    return name ? name[1] : "<unknown>";
+  }
+}
+const engagementTelemetry = new EngagementTelemetry();
+export {
+  engagementTelemetry
+};
+//# sourceMappingURL=engagement.mjs.map

package/lib/telemetry/engagement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/engagement.ts"],"sourcesContent":["/**\n * Copyright 2024 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ValueType, type Attributes } from '@opentelemetry/api';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { GENKIT_VERSION } from 'genkit';\nimport { logger } from 'genkit/logging';\nimport {\n  MetricCounter,\n  internalMetricNamespaceWrap,\n  type Telemetry,\n} from '../metrics.js';\nimport { createCommonLogAttributes, truncate } from '../utils.js';\n\nclass EngagementTelemetry implements Telemetry {\n  /**\n   * Wraps the declared metrics in a Genkit-specific, internal namespace.\n   */\n  private _N = internalMetricNamespaceWrap.bind(null, 'engagement');\n\n  private feedbackCounter = new MetricCounter(this._N('feedback'), {\n    description: 'Counts calls to genkit flows.',\n    valueType: ValueType.INT,\n  });\n\n  private acceptanceCounter = new MetricCounter(this._N('acceptance'), {\n    description: 'Tracks unique flow paths per flow.',\n    valueType: ValueType.INT,\n  });\n\n  tick(\n    span: ReadableSpan,\n    logInputAndOutput: boolean,\n    projectId?: string\n  ): void {\n    const subtype = span.attributes['genkit:metadata:subtype'] as string;\n\n    if (subtype === 'userFeedback') {\n      this.writeUserFeedback(span, projectId);\n      return;\n    }\n\n    if (subtype === 'userAcceptance') {\n      this.writeUserAcceptance(span, projectId);\n      return;\n    }\n\n    logger.warn(`Unknown user engagement subtype: ${subtype}`);\n  }\n\n  private writeUserFeedback(span: ReadableSpan, projectId?: string) {\n    const attributes = span.attributes;\n    const name = this.extractTraceName(attributes);\n\n    const dimensions = {\n      name,\n      value: attributes['genkit:metadata:feedbackValue'],\n      hasText: !!attributes['genkit:metadata:textFeedback'],\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n    };\n    this.feedbackCounter.add(1, dimensions);\n\n    const metadata = {\n      ...createCommonLogAttributes(span, projectId),\n      feedbackValue: attributes['genkit:metadata:feedbackValue'],\n    };\n    if (attributes['genkit:metadata:textFeedback']) {\n      metadata['textFeedback'] = truncate(\n        attributes['genkit:metadata:textFeedback'] as string\n      );\n    }\n    logger.logStructured(`UserFeedback[${name}]`, metadata);\n  }\n\n  private writeUserAcceptance(span: ReadableSpan, projectId?: string) {\n    const attributes = span.attributes;\n    const name = this.extractTraceName(attributes);\n\n    const dimensions = {\n      name,\n      value: attributes['genkit:metadata:acceptanceValue'],\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n    };\n    this.acceptanceCounter.add(1, dimensions);\n\n    const metadata = {\n      ...createCommonLogAttributes(span, projectId),\n      acceptanceValue: attributes['genkit:metadata:acceptanceValue'],\n    };\n    logger.logStructured(`UserAcceptance[${name}]`, metadata);\n  }\n\n  private extractTraceName(attributes: Attributes) {\n    const path = attributes['genkit:path'] as string;\n    if (!path || path === '<unknown>') {\n      return '<unknown>';\n    }\n\n    const name = path.match('/{(.+)}+');\n    return name ? name[1] : '<unknown>';\n  }\n}\n\nconst engagementTelemetry = new EngagementTelemetry();\nexport { engagementTelemetry };\n"],"mappings":"AAgBA,SAAS,iBAAkC;AAE3C,SAAS,sBAAsB;AAC/B,SAAS,cAAc;AACvB;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,SAAS,2BAA2B,gBAAgB;AAEpD,MAAM,oBAAyC;AAAA;AAAA;AAAA;AAAA,EAIrC,KAAK,4BAA4B,KAAK,MAAM,YAAY;AAAA,EAExD,kBAAkB,IAAI,cAAc,KAAK,GAAG,UAAU,GAAG;AAAA,IAC/D,aAAa;AAAA,IACb,WAAW,UAAU;AAAA,EACvB,CAAC;AAAA,EAEO,oBAAoB,IAAI,cAAc,KAAK,GAAG,YAAY,GAAG;AAAA,IACnE,aAAa;AAAA,IACb,WAAW,UAAU;AAAA,EACvB,CAAC;AAAA,EAED,KACE,MACA,mBACA,WACM;AACN,UAAM,UAAU,KAAK,WAAW,yBAAyB;AAEzD,QAAI,YAAY,gBAAgB;AAC9B,WAAK,kBAAkB,MAAM,SAAS;AACtC;AAAA,IACF;AAEA,QAAI,YAAY,kBAAkB;AAChC,WAAK,oBAAoB,MAAM,SAAS;AACxC;AAAA,IACF;AAEA,WAAO,KAAK,oCAAoC,OAAO,EAAE;AAAA,EAC3D;AAAA,EAEQ,kBAAkB,MAAoB,WAAoB;AAChE,UAAM,aAAa,KAAK;AACxB,UAAM,OAAO,KAAK,iBAAiB,UAAU;AAE7C,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,OAAO,WAAW,+BAA+B;AAAA,MACjD,SAAS,CAAC,CAAC,WAAW,8BAA8B;AAAA,MACpD,QAAQ;AAAA,MACR,eAAe;AAAA,IACjB;AACA,SAAK,gBAAgB,IAAI,GAAG,UAAU;AAEtC,UAAM,WAAW;AAAA,MACf,GAAG,0BAA0B,MAAM,SAAS;AAAA,MAC5C,eAAe,WAAW,+BAA+B;AAAA,IAC3D;AACA,QAAI,WAAW,8BAA8B,GAAG;AAC9C,eAAS,cAAc,IAAI;AAAA,QACzB,WAAW,8BAA8B;AAAA,MAC3C;AAAA,IACF;AACA,WAAO,cAAc,gBAAgB,IAAI,KAAK,QAAQ;AAAA,EACxD;AAAA,EAEQ,oBAAoB,MAAoB,WAAoB;AAClE,UAAM,aAAa,KAAK;AACxB,UAAM,OAAO,KAAK,iBAAiB,UAAU;AAE7C,UAAM,aAAa;AAAA,MACjB;AAAA,MACA,OAAO,WAAW,iCAAiC;AAAA,MACnD,QAAQ;AAAA,MACR,eAAe;AAAA,IACjB;AACA,SAAK,kBAAkB,IAAI,GAAG,UAAU;AAExC,UAAM,WAAW;AAAA,MACf,GAAG,0BAA0B,MAAM,SAAS;AAAA,MAC5C,iBAAiB,WAAW,iCAAiC;AAAA,IAC/D;AACA,WAAO,cAAc,kBAAkB,IAAI,KAAK,QAAQ;AAAA,EAC1D;AAAA,EAEQ,iBAAiB,YAAwB;AAC/C,UAAM,OAAO,WAAW,aAAa;AACrC,QAAI,CAAC,QAAQ,SAAS,aAAa;AACjC,aAAO;AAAA,IACT;AAEA,UAAM,OAAO,KAAK,MAAM,UAAU;AAClC,WAAO,OAAO,KAAK,CAAC,IAAI;AAAA,EAC1B;AACF;AAEA,MAAM,sBAAsB,IAAI,oBAAoB;","names":[]}

package/lib/telemetry/feature.d.mts

@@ -0,0 +1,35 @@
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { Telemetry } from '../metrics.mjs';
+import '@opentelemetry/api';
+
+/**
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class FeaturesTelemetry implements Telemetry {
+    /**
+     * Wraps the declared metrics in a Genkit-specific, internal namespace.
+     */
+    private _N;
+    private featureCounter;
+    private featureLatencies;
+    tick(span: ReadableSpan, logInputAndOutput: boolean, projectId?: string): void;
+    private writeFeatureSuccess;
+    private writeFeatureFailure;
+    private writeLog;
+}
+declare const featuresTelemetry: FeaturesTelemetry;
+
+export { featuresTelemetry };

package/lib/telemetry/feature.d.ts

@@ -0,0 +1,35 @@
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { Telemetry } from '../metrics.js';
+import '@opentelemetry/api';
+
+/**
+ * Copyright 2024 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare class FeaturesTelemetry implements Telemetry {
+    /**
+     * Wraps the declared metrics in a Genkit-specific, internal namespace.
+     */
+    private _N;
+    private featureCounter;
+    private featureLatencies;
+    tick(span: ReadableSpan, logInputAndOutput: boolean, projectId?: string): void;
+    private writeFeatureSuccess;
+    private writeFeatureFailure;
+    private writeLog;
+}
+declare const featuresTelemetry: FeaturesTelemetry;
+
+export { featuresTelemetry };

package/lib/telemetry/feature.js

@@ -0,0 +1,142 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var feature_exports = {};
+__export(feature_exports, {
+  featuresTelemetry: () => featuresTelemetry
+});
+module.exports = __toCommonJS(feature_exports);
+var import_api = require("@opentelemetry/api");
+var import_core = require("@opentelemetry/core");
+var import_genkit = require("genkit");
+var import_logging = require("genkit/logging");
+var import_tracing = require("genkit/tracing");
+var import_metrics = require("../metrics.js");
+var import_utils = require("../utils.js");
+class FeaturesTelemetry {
+  /**
+   * Wraps the declared metrics in a Genkit-specific, internal namespace.
+   */
+  _N = import_metrics.internalMetricNamespaceWrap.bind(null, "feature");
+  featureCounter = new import_metrics.MetricCounter(this._N("requests"), {
+    description: "Counts calls to genkit features.",
+    valueType: import_api.ValueType.INT
+  });
+  featureLatencies = new import_metrics.MetricHistogram(this._N("latency"), {
+    description: "Latencies when calling Genkit features.",
+    valueType: import_api.ValueType.DOUBLE,
+    unit: "ms"
+  });
+  tick(span, logInputAndOutput, projectId) {
+    const attributes = span.attributes;
+    const name = attributes["genkit:name"];
+    const path = attributes["genkit:path"];
+    const latencyMs = (0, import_core.hrTimeToMilliseconds)(
+      (0, import_core.hrTimeDuration)(span.startTime, span.endTime)
+    );
+    const isRoot = attributes["genkit:isRoot"];
+    if (!isRoot) {
+      throw new import_genkit.GenkitError({
+        status: "FAILED_PRECONDITION",
+        message: "FeatureTelemetry tick called with non-root span."
+      });
+    }
+    const state = attributes["genkit:state"];
+    if (state === "success") {
+      this.writeFeatureSuccess(name, latencyMs);
+    } else if (state === "error") {
+      const errorName = (0, import_utils.extractErrorName)(span.events) || "<unknown>";
+      this.writeFeatureFailure(name, latencyMs, errorName);
+    } else {
+      import_logging.logger.warn(`Unknown state; ${state}`);
+      return;
+    }
+    if (logInputAndOutput) {
+      const input = (0, import_utils.truncate)(attributes["genkit:input"]);
+      const output = (0, import_utils.truncate)(attributes["genkit:output"]);
+      const sessionId = attributes["genkit:sessionId"];
+      const threadName = attributes["genkit:threadName"];
+      if (input) {
+        this.writeLog(
+          span,
+          "Input",
+          name,
+          path,
+          input,
+          projectId,
+          sessionId,
+          threadName
+        );
+      }
+      if (output) {
+        this.writeLog(
+          span,
+          "Output",
+          name,
+          path,
+          output,
+          projectId,
+          sessionId,
+          threadName
+        );
+      }
+    }
+  }
+  writeFeatureSuccess(featureName, latencyMs) {
+    const dimensions = {
+      name: featureName,
+      status: "success",
+      source: "ts",
+      sourceVersion: import_genkit.GENKIT_VERSION
+    };
+    this.featureCounter.add(1, dimensions);
+    this.featureLatencies.record(latencyMs, dimensions);
+  }
+  writeFeatureFailure(featureName, latencyMs, errorName) {
+    const dimensions = {
+      name: featureName,
+      status: "failure",
+      source: "ts",
+      sourceVersion: import_genkit.GENKIT_VERSION,
+      error: errorName
+    };
+    this.featureCounter.add(1, dimensions);
+    this.featureLatencies.record(latencyMs, dimensions);
+  }
+  writeLog(span, tag, featureName, qualifiedPath, content, projectId, sessionId, threadName) {
+    const path = (0, import_utils.truncatePath)((0, import_tracing.toDisplayPath)(qualifiedPath));
+    const sharedMetadata = {
+      ...(0, import_utils.createCommonLogAttributes)(span, projectId),
+      path,
+      qualifiedPath,
+      featureName,
+      sessionId,
+      threadName
+    };
+    import_logging.logger.logStructured(`${tag}[${path}, ${featureName}]`, {
+      ...sharedMetadata,
+      content
+    });
+  }
+}
+const featuresTelemetry = new FeaturesTelemetry();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  featuresTelemetry
+});
+//# sourceMappingURL=feature.js.map

package/lib/telemetry/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/feature.ts"],"sourcesContent":["/**\n * Copyright 2024 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ValueType } from '@opentelemetry/api';\nimport { hrTimeDuration, hrTimeToMilliseconds } from '@opentelemetry/core';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { GENKIT_VERSION, GenkitError } from 'genkit';\nimport { logger } from 'genkit/logging';\nimport { toDisplayPath } from 'genkit/tracing';\nimport {\n  MetricCounter,\n  MetricHistogram,\n  internalMetricNamespaceWrap,\n  type Telemetry,\n} from '../metrics.js';\nimport {\n  createCommonLogAttributes,\n  extractErrorName,\n  truncate,\n  truncatePath,\n} from '../utils.js';\n\nclass FeaturesTelemetry implements Telemetry {\n  /**\n   * Wraps the declared metrics in a Genkit-specific, internal namespace.\n   */\n  private _N = internalMetricNamespaceWrap.bind(null, 'feature');\n\n  private featureCounter = new MetricCounter(this._N('requests'), {\n    description: 'Counts calls to genkit features.',\n    valueType: ValueType.INT,\n  });\n\n  private featureLatencies = new MetricHistogram(this._N('latency'), {\n    description: 'Latencies when calling Genkit features.',\n    valueType: ValueType.DOUBLE,\n    unit: 'ms',\n  });\n\n  tick(\n    span: ReadableSpan,\n    logInputAndOutput: boolean,\n    projectId?: string\n  ): void {\n    const attributes = span.attributes;\n    const name = attributes['genkit:name'] as string;\n    const path = attributes['genkit:path'] as string;\n    const latencyMs = hrTimeToMilliseconds(\n      hrTimeDuration(span.startTime, span.endTime)\n    );\n    const isRoot = attributes['genkit:isRoot'] as boolean;\n    if (!isRoot) {\n      throw new GenkitError({\n        status: 'FAILED_PRECONDITION',\n        message: 'FeatureTelemetry tick called with non-root span.',\n      });\n    }\n    const state = attributes['genkit:state'] as string;\n\n    if (state === 'success') {\n      this.writeFeatureSuccess(name, latencyMs);\n    } else if (state === 'error') {\n      const errorName = extractErrorName(span.events) || '<unknown>';\n      this.writeFeatureFailure(name, latencyMs, errorName);\n    } else {\n      logger.warn(`Unknown state; ${state}`);\n      return;\n    }\n\n    if (logInputAndOutput) {\n      const input = truncate(attributes['genkit:input'] as string);\n      const output = truncate(attributes['genkit:output'] as string);\n      const sessionId = attributes['genkit:sessionId'] as string;\n      const threadName = attributes['genkit:threadName'] as string;\n\n      if (input) {\n        this.writeLog(\n          span,\n          'Input',\n          name,\n          path,\n          input,\n          projectId,\n          sessionId,\n          threadName\n        );\n      }\n      if (output) {\n        this.writeLog(\n          span,\n          'Output',\n          name,\n          path,\n          output,\n          projectId,\n          sessionId,\n          threadName\n        );\n      }\n    }\n  }\n\n  private writeFeatureSuccess(featureName: string, latencyMs: number) {\n    const dimensions = {\n      name: featureName,\n      status: 'success',\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n    };\n    this.featureCounter.add(1, dimensions);\n    this.featureLatencies.record(latencyMs, dimensions);\n  }\n\n  private writeFeatureFailure(\n    featureName: string,\n    latencyMs: number,\n    errorName: string\n  ) {\n    const dimensions = {\n      name: featureName,\n      status: 'failure',\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n      error: errorName,\n    };\n    this.featureCounter.add(1, dimensions);\n    this.featureLatencies.record(latencyMs, dimensions);\n  }\n\n  private writeLog(\n    span: ReadableSpan,\n    tag: string,\n    featureName: string,\n    qualifiedPath: string,\n    content: string,\n    projectId?: string,\n    sessionId?: string,\n    threadName?: string\n  ) {\n    const path = truncatePath(toDisplayPath(qualifiedPath));\n    const sharedMetadata = {\n      ...createCommonLogAttributes(span, projectId),\n      path,\n      qualifiedPath,\n      featureName,\n      sessionId,\n      threadName,\n    };\n    logger.logStructured(`${tag}[${path}, ${featureName}]`, {\n      ...sharedMetadata,\n      content,\n    });\n  }\n}\n\nconst featuresTelemetry = new FeaturesTelemetry();\nexport { featuresTelemetry };\n"],"mappings":"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","names":[]}

package/lib/telemetry/feature.mjs

@@ -0,0 +1,127 @@
+import { ValueType } from "@opentelemetry/api";
+import { hrTimeDuration, hrTimeToMilliseconds } from "@opentelemetry/core";
+import { GENKIT_VERSION, GenkitError } from "genkit";
+import { logger } from "genkit/logging";
+import { toDisplayPath } from "genkit/tracing";
+import {
+  MetricCounter,
+  MetricHistogram,
+  internalMetricNamespaceWrap
+} from "../metrics.js";
+import {
+  createCommonLogAttributes,
+  extractErrorName,
+  truncate,
+  truncatePath
+} from "../utils.js";
+class FeaturesTelemetry {
+  /**
+   * Wraps the declared metrics in a Genkit-specific, internal namespace.
+   */
+  _N = internalMetricNamespaceWrap.bind(null, "feature");
+  featureCounter = new MetricCounter(this._N("requests"), {
+    description: "Counts calls to genkit features.",
+    valueType: ValueType.INT
+  });
+  featureLatencies = new MetricHistogram(this._N("latency"), {
+    description: "Latencies when calling Genkit features.",
+    valueType: ValueType.DOUBLE,
+    unit: "ms"
+  });
+  tick(span, logInputAndOutput, projectId) {
+    const attributes = span.attributes;
+    const name = attributes["genkit:name"];
+    const path = attributes["genkit:path"];
+    const latencyMs = hrTimeToMilliseconds(
+      hrTimeDuration(span.startTime, span.endTime)
+    );
+    const isRoot = attributes["genkit:isRoot"];
+    if (!isRoot) {
+      throw new GenkitError({
+        status: "FAILED_PRECONDITION",
+        message: "FeatureTelemetry tick called with non-root span."
+      });
+    }
+    const state = attributes["genkit:state"];
+    if (state === "success") {
+      this.writeFeatureSuccess(name, latencyMs);
+    } else if (state === "error") {
+      const errorName = extractErrorName(span.events) || "<unknown>";
+      this.writeFeatureFailure(name, latencyMs, errorName);
+    } else {
+      logger.warn(`Unknown state; ${state}`);
+      return;
+    }
+    if (logInputAndOutput) {
+      const input = truncate(attributes["genkit:input"]);
+      const output = truncate(attributes["genkit:output"]);
+      const sessionId = attributes["genkit:sessionId"];
+      const threadName = attributes["genkit:threadName"];
+      if (input) {
+        this.writeLog(
+          span,
+          "Input",
+          name,
+          path,
+          input,
+          projectId,
+          sessionId,
+          threadName
+        );
+      }
+      if (output) {
+        this.writeLog(
+          span,
+          "Output",
+          name,
+          path,
+          output,
+          projectId,
+          sessionId,
+          threadName
+        );
+      }
+    }
+  }
+  writeFeatureSuccess(featureName, latencyMs) {
+    const dimensions = {
+      name: featureName,
+      status: "success",
+      source: "ts",
+      sourceVersion: GENKIT_VERSION
+    };
+    this.featureCounter.add(1, dimensions);
+    this.featureLatencies.record(latencyMs, dimensions);
+  }
+  writeFeatureFailure(featureName, latencyMs, errorName) {
+    const dimensions = {
+      name: featureName,
+      status: "failure",
+      source: "ts",
+      sourceVersion: GENKIT_VERSION,
+      error: errorName
+    };
+    this.featureCounter.add(1, dimensions);
+    this.featureLatencies.record(latencyMs, dimensions);
+  }
+  writeLog(span, tag, featureName, qualifiedPath, content, projectId, sessionId, threadName) {
+    const path = truncatePath(toDisplayPath(qualifiedPath));
+    const sharedMetadata = {
+      ...createCommonLogAttributes(span, projectId),
+      path,
+      qualifiedPath,
+      featureName,
+      sessionId,
+      threadName
+    };
+    logger.logStructured(`${tag}[${path}, ${featureName}]`, {
+      ...sharedMetadata,
+      content
+    });
+  }
+}
+const featuresTelemetry = new FeaturesTelemetry();
+export {
+  featuresTelemetry
+};
+//# sourceMappingURL=feature.mjs.map

package/lib/telemetry/feature.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/feature.ts"],"sourcesContent":["/**\n * Copyright 2024 Google LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { ValueType } from '@opentelemetry/api';\nimport { hrTimeDuration, hrTimeToMilliseconds } from '@opentelemetry/core';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { GENKIT_VERSION, GenkitError } from 'genkit';\nimport { logger } from 'genkit/logging';\nimport { toDisplayPath } from 'genkit/tracing';\nimport {\n  MetricCounter,\n  MetricHistogram,\n  internalMetricNamespaceWrap,\n  type Telemetry,\n} from '../metrics.js';\nimport {\n  createCommonLogAttributes,\n  extractErrorName,\n  truncate,\n  truncatePath,\n} from '../utils.js';\n\nclass FeaturesTelemetry implements Telemetry {\n  /**\n   * Wraps the declared metrics in a Genkit-specific, internal namespace.\n   */\n  private _N = internalMetricNamespaceWrap.bind(null, 'feature');\n\n  private featureCounter = new MetricCounter(this._N('requests'), {\n    description: 'Counts calls to genkit features.',\n    valueType: ValueType.INT,\n  });\n\n  private featureLatencies = new MetricHistogram(this._N('latency'), {\n    description: 'Latencies when calling Genkit features.',\n    valueType: ValueType.DOUBLE,\n    unit: 'ms',\n  });\n\n  tick(\n    span: ReadableSpan,\n    logInputAndOutput: boolean,\n    projectId?: string\n  ): void {\n    const attributes = span.attributes;\n    const name = attributes['genkit:name'] as string;\n    const path = attributes['genkit:path'] as string;\n    const latencyMs = hrTimeToMilliseconds(\n      hrTimeDuration(span.startTime, span.endTime)\n    );\n    const isRoot = attributes['genkit:isRoot'] as boolean;\n    if (!isRoot) {\n      throw new GenkitError({\n        status: 'FAILED_PRECONDITION',\n        message: 'FeatureTelemetry tick called with non-root span.',\n      });\n    }\n    const state = attributes['genkit:state'] as string;\n\n    if (state === 'success') {\n      this.writeFeatureSuccess(name, latencyMs);\n    } else if (state === 'error') {\n      const errorName = extractErrorName(span.events) || '<unknown>';\n      this.writeFeatureFailure(name, latencyMs, errorName);\n    } else {\n      logger.warn(`Unknown state; ${state}`);\n      return;\n    }\n\n    if (logInputAndOutput) {\n      const input = truncate(attributes['genkit:input'] as string);\n      const output = truncate(attributes['genkit:output'] as string);\n      const sessionId = attributes['genkit:sessionId'] as string;\n      const threadName = attributes['genkit:threadName'] as string;\n\n      if (input) {\n        this.writeLog(\n          span,\n          'Input',\n          name,\n          path,\n          input,\n          projectId,\n          sessionId,\n          threadName\n        );\n      }\n      if (output) {\n        this.writeLog(\n          span,\n          'Output',\n          name,\n          path,\n          output,\n          projectId,\n          sessionId,\n          threadName\n        );\n      }\n    }\n  }\n\n  private writeFeatureSuccess(featureName: string, latencyMs: number) {\n    const dimensions = {\n      name: featureName,\n      status: 'success',\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n    };\n    this.featureCounter.add(1, dimensions);\n    this.featureLatencies.record(latencyMs, dimensions);\n  }\n\n  private writeFeatureFailure(\n    featureName: string,\n    latencyMs: number,\n    errorName: string\n  ) {\n    const dimensions = {\n      name: featureName,\n      status: 'failure',\n      source: 'ts',\n      sourceVersion: GENKIT_VERSION,\n      error: errorName,\n    };\n    this.featureCounter.add(1, dimensions);\n    this.featureLatencies.record(latencyMs, dimensions);\n  }\n\n  private writeLog(\n    span: ReadableSpan,\n    tag: string,\n    featureName: string,\n    qualifiedPath: string,\n    content: string,\n    projectId?: string,\n    sessionId?: string,\n    threadName?: string\n  ) {\n    const path = truncatePath(toDisplayPath(qualifiedPath));\n    const sharedMetadata = {\n      ...createCommonLogAttributes(span, projectId),\n      path,\n      qualifiedPath,\n      featureName,\n      sessionId,\n      threadName,\n    };\n    logger.logStructured(`${tag}[${path}, ${featureName}]`, {\n      ...sharedMetadata,\n      content,\n    });\n  }\n}\n\nconst featuresTelemetry = new FeaturesTelemetry();\nexport { featuresTelemetry };\n"],"mappings":"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","names":[]}