Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .github/workflows/fi-core-typescript-tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ on:
paths:
- 'typescript/packages/fi-core/**'
- 'typescript/packages/fi-semantic-conventions/**'
- 'python/fi_instrumentation/fi_types.py'
- 'typescript/pnpm-lock.yaml'
- 'typescript/tsconfig*'
- '.github/workflows/fi-core-typescript-tests.yml'
Expand All @@ -14,6 +15,7 @@ on:
paths:
- 'typescript/packages/fi-core/**'
- 'typescript/packages/fi-semantic-conventions/**'
- 'python/fi_instrumentation/fi_types.py'
- 'typescript/pnpm-lock.yaml'
- 'typescript/tsconfig*'
- '.github/workflows/fi-core-typescript-tests.yml'
Expand Down Expand Up @@ -62,5 +64,6 @@ jobs:
ip link set lo up
export FI_CORE_PACKAGE_JSON="$1/node_modules/@traceai/fi-core/package.json"
"$2" --test "$3/typescript/packages/fi-core/test/provider-lifecycle.test.cjs" &&
"$2" "$3/typescript/node_modules/jest/bin/jest.js" --config "$3/typescript/packages/fi-semantic-conventions/jest.config.js" --runInBand --no-cache &&
"$2" "$3/typescript/node_modules/jest/bin/jest.js" --config "$3/typescript/packages/fi-core/jest.config.js" --runInBand
' sh "$RUNNER_TEMP/sdk-fixture" "$NODE" "$GITHUB_WORKSPACE"
4 changes: 2 additions & 2 deletions .release-please-manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@
"python/frameworks/xai": "0.1.1",
"python/traceai": "0.1.0",
"typescript/packages/fi-core": "1.2.3",
"typescript/packages/fi-semantic-conventions": "1.1.0",
"typescript/packages/fi-semantic-conventions": "1.2.0",
"typescript/packages/traceai_anthropic": "0.1.5",
"typescript/packages/traceai_auto": "0.1.3",
"typescript/packages/traceai_bedrock": "0.1.3",
Expand Down Expand Up @@ -119,7 +119,7 @@
"typescript/packages/traceai_voltagent": "0.1.0",
"typescript/packages/traceai_weaviate": "0.1.3",
"typescript/packages/traceai_xai": "0.1.1",
"java": "1.0.3",
"java": "1.1.0",
"go/a2a": "0.1.1",
"go/anthropic": "0.1.0",
"go/eino": "0.1.0",
Expand Down
6 changes: 6 additions & 0 deletions java/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
# Changelog

## [1.1.0](https://github.com/future-agi/traceAI/compare/java-v1.0.3...java-v1.1.0) (2026-11-10)

### Features

* **java-core:** add Python-aligned `GEN_AI_*` names for every GenAI attribute in `SemanticConventions`. The 16 legacy `LLM_*` names stay as deprecated compile-time aliases with identical values, so existing source and binaries keep working; `LLM_SYSTEM` maps to `GEN_AI_PROVIDER_NAME` (`gen_ai.provider.name`) ([#654](https://github.com/future-agi/traceAI/pull/654), TH-3776).

## [1.0.3](https://github.com/future-agi/traceAI/compare/java-v1.0.2...java-v1.0.3) (2026-11-10)

### Features
Expand Down
10 changes: 5 additions & 5 deletions java/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ OpenTelemetry instrumentation for Java AI applications. Trace LLM calls, embeddi

Release coordinates use **`com.futureagi`**. Artifact names are unchanged, and **Java package names remain `ai.traceai.*`**; existing imports do not change.

The install examples track Java SDK `1.0.3`, matching [`pom.xml`](pom.xml); release-please updates them together. All SDK modules inherit that version, and the BOM aligns them. <!-- x-release-please-version -->
The install examples track Java SDK `1.1.0`, matching [`pom.xml`](pom.xml); release-please updates them together. All SDK modules inherit that version, and the BOM aligns them. <!-- x-release-please-version -->

> **Unreleased API:** the [provider ownership and shutdown](#provider-ownership-and-shutdown) behavior below, including `TraceAI.init(TraceConfig, OpenTelemetry)`, is not in the immutable Central releases `1.0.0` or `1.0.1`. Until a new release containing it is published and passes the [external-consumer check](#validate-readme-coordinates), that section requires a verified source build of this checkout. Installing an older Central release or the historical JitPack commit below is not sufficient. The basic OpenAI quickstart remains available from Central.

Expand All @@ -20,7 +20,7 @@ Import the BOM once, then add the instrumentation you need:
<dependency>
<groupId>com.futureagi</groupId>
<artifactId>traceai-bom</artifactId>
<version>1.0.3</version> <!-- x-release-please-version -->
<version>1.1.0</version> <!-- x-release-please-version -->
<type>pom</type>
<scope>import</scope>
</dependency>
Expand All @@ -42,7 +42,7 @@ Import the BOM once, then add the instrumentation you need:
</dependencies>
```

Without the BOM, specify `<version>1.0.3</version>` on each traceAI dependency. <!-- x-release-please-version -->
Without the BOM, specify `<version>1.1.0</version>` on each traceAI dependency. <!-- x-release-please-version -->

For Spring Boot auto-configuration, **add** `traceai-spring-boot-starter` alongside `traceai-java-openai` and the OpenAI SDK shown above:

Expand All @@ -63,7 +63,7 @@ repositories {
}

dependencies {
implementation platform('com.futureagi:traceai-bom:1.0.3') // x-release-please-version
implementation platform('com.futureagi:traceai-bom:1.1.0') // x-release-please-version
implementation 'com.futureagi:traceai-java-openai'
implementation 'com.openai:openai-java:0.8.0'
// For Spring Boot auto-configuration, add this as well (do not replace OpenAI):
Expand Down Expand Up @@ -190,7 +190,7 @@ Add `com.futureagi:traceai-java-core` to your application using the BOM above, o
<dependency>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-core</artifactId>
<version>1.0.3</version> <!-- x-release-please-version -->
<version>1.1.0</version> <!-- x-release-please-version -->
</dependency>
```

Expand Down
2 changes: 1 addition & 1 deletion java/compatibility/spring-ai/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<!-- Deliberately outside the reactor: tests the installed JAR, never module classes. -->
<properties>
<maven.compiler.release>17</maven.compiler.release><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<traceai.version>1.0.3</traceai.version><!-- x-release-please-version -->
<traceai.version>1.1.0</traceai.version><!-- x-release-please-version -->
<spring-ai.version>1.1.8</spring-ai.version><spring-boot.version>3.5.15</spring-boot.version>
<factory.source>src/spring1/java</factory.source>
</properties>
Expand Down
2 changes: 1 addition & 1 deletion java/examples/azure-openai-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/azure-search-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/elasticsearch-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/langchain4j-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/openai-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/pgvector-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/rag-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/semantic-kernel-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/examples/watsonx-example/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<relativePath>../../pom.xml</relativePath>
</parent>

Expand Down
2 changes: 1 addition & 1 deletion java/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
<packaging>pom</packaging>

<name>TraceAI Java SDK</name>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-bom/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>
<artifactId>traceai-bom</artifactId>
<packaging>pom</packaging>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-anthropic/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-anthropic</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-azure-openai/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-azure-openai</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-azure-search-v12/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-azure-search-v12</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-azure-search/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-azure-search</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-bedrock/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-bedrock</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-chromadb/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-chromadb</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-cohere/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-cohere</artifactId>
Expand Down
2 changes: 1 addition & 1 deletion java/traceai-java-core/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<parent>
<groupId>com.futureagi</groupId>
<artifactId>traceai-java-parent</artifactId>
<version>1.0.3</version>
<version>1.1.0</version>
</parent>

<artifactId>traceai-java-core</artifactId>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -97,33 +97,82 @@ public final class SemanticConventions {
public static final String GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
public static final String GEN_AI_SYSTEM = "gen_ai.system";

// LLM System/Provider — both resolve to gen_ai.provider.name
public static final String LLM_SYSTEM = "gen_ai.provider.name";
public static final String LLM_PROVIDER = "gen_ai.provider.name";
public static final String GEN_AI_PROVIDER_NAME = "gen_ai.provider.name";

/** @deprecated Use {@link #GEN_AI_PROVIDER_NAME}. */
@Deprecated
public static final String LLM_SYSTEM = GEN_AI_PROVIDER_NAME;
/** @deprecated Use {@link #GEN_AI_PROVIDER_NAME}. */
@Deprecated
public static final String LLM_PROVIDER = GEN_AI_PROVIDER_NAME;

// ── GenAI Request ────────────────────────────────────────────────
public static final String LLM_MODEL_NAME = "gen_ai.request.model";
public static final String LLM_REQUEST_MODEL = "gen_ai.request.model";
public static final String LLM_REQUEST_TEMPERATURE = "gen_ai.request.temperature";
public static final String LLM_REQUEST_TOP_P = "gen_ai.request.top_p";
public static final String GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
public static final String GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature";
public static final String GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p";

/** @deprecated Use {@link #GEN_AI_REQUEST_MODEL}. */
@Deprecated
public static final String LLM_MODEL_NAME = GEN_AI_REQUEST_MODEL;
/** @deprecated Use {@link #GEN_AI_REQUEST_MODEL}. */
@Deprecated
public static final String LLM_REQUEST_MODEL = GEN_AI_REQUEST_MODEL;
/** @deprecated Use {@link #GEN_AI_REQUEST_TEMPERATURE}. */
@Deprecated
public static final String LLM_REQUEST_TEMPERATURE = GEN_AI_REQUEST_TEMPERATURE;
/** @deprecated Use {@link #GEN_AI_REQUEST_TOP_P}. */
@Deprecated
public static final String LLM_REQUEST_TOP_P = GEN_AI_REQUEST_TOP_P;
public static final String GEN_AI_REQUEST_TOP_K = "gen_ai.request.top_k";
public static final String LLM_REQUEST_MAX_TOKENS = "gen_ai.request.max_tokens";
public static final String GEN_AI_REQUEST_MAX_TOKENS = "gen_ai.request.max_tokens";

/** @deprecated Use {@link #GEN_AI_REQUEST_MAX_TOKENS}. */
@Deprecated
public static final String LLM_REQUEST_MAX_TOKENS = GEN_AI_REQUEST_MAX_TOKENS;
public static final String GEN_AI_REQUEST_FREQUENCY_PENALTY = "gen_ai.request.frequency_penalty";
public static final String GEN_AI_REQUEST_PRESENCE_PENALTY = "gen_ai.request.presence_penalty";
public static final String LLM_REQUEST_STOP_SEQUENCES = "gen_ai.request.stop_sequences";
public static final String GEN_AI_REQUEST_STOP_SEQUENCES = "gen_ai.request.stop_sequences";

/** @deprecated Use {@link #GEN_AI_REQUEST_STOP_SEQUENCES}. */
@Deprecated
public static final String LLM_REQUEST_STOP_SEQUENCES = GEN_AI_REQUEST_STOP_SEQUENCES;
public static final String GEN_AI_REQUEST_SEED = "gen_ai.request.seed";
public static final String GEN_AI_REQUEST_PARAMETERS = "gen_ai.request.parameters";

// ── GenAI Response ───────────────────────────────────────────────
public static final String LLM_RESPONSE_MODEL = "gen_ai.response.model";
public static final String LLM_RESPONSE_ID = "gen_ai.response.id";
public static final String LLM_RESPONSE_FINISH_REASON = "gen_ai.response.finish_reasons";
public static final String GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";

/** @deprecated Use {@link #GEN_AI_RESPONSE_MODEL}. */
@Deprecated
public static final String LLM_RESPONSE_MODEL = GEN_AI_RESPONSE_MODEL;
public static final String GEN_AI_RESPONSE_ID = "gen_ai.response.id";

/** @deprecated Use {@link #GEN_AI_RESPONSE_ID}. */
@Deprecated
public static final String LLM_RESPONSE_ID = GEN_AI_RESPONSE_ID;
public static final String GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";

/** @deprecated Use {@link #GEN_AI_RESPONSE_FINISH_REASONS}. */
@Deprecated
public static final String LLM_RESPONSE_FINISH_REASON = GEN_AI_RESPONSE_FINISH_REASONS;
public static final String GEN_AI_OUTPUT_TYPE = "gen_ai.output.type";

// ── GenAI Usage / Tokens ─────────────────────────────────────────
public static final String LLM_TOKEN_COUNT_PROMPT = "gen_ai.usage.input_tokens";
public static final String LLM_TOKEN_COUNT_COMPLETION = "gen_ai.usage.output_tokens";
public static final String LLM_TOKEN_COUNT_TOTAL = "gen_ai.usage.total_tokens";
public static final String GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";

/** @deprecated Use {@link #GEN_AI_USAGE_INPUT_TOKENS}. */
@Deprecated
public static final String LLM_TOKEN_COUNT_PROMPT = GEN_AI_USAGE_INPUT_TOKENS;
public static final String GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";

/** @deprecated Use {@link #GEN_AI_USAGE_OUTPUT_TOKENS}. */
@Deprecated
public static final String LLM_TOKEN_COUNT_COMPLETION = GEN_AI_USAGE_OUTPUT_TOKENS;
public static final String GEN_AI_USAGE_TOTAL_TOKENS = "gen_ai.usage.total_tokens";

/** @deprecated Use {@link #GEN_AI_USAGE_TOTAL_TOKENS}. */
@Deprecated
public static final String LLM_TOKEN_COUNT_TOTAL = GEN_AI_USAGE_TOTAL_TOKENS;
public static final String GEN_AI_USAGE_CACHE_READ_TOKENS = "gen_ai.usage.cache_read_tokens";
public static final String GEN_AI_USAGE_CACHE_WRITE_TOKENS = "gen_ai.usage.cache_write_tokens";

Expand All @@ -137,8 +186,16 @@ public final class SemanticConventions {
public static final String GEN_AI_USAGE_INPUT_TOKENS_CACHE_WRITE = "gen_ai.usage.input_tokens.cache_write";

// ── GenAI Messages ───────────────────────────────────────────────
public static final String LLM_INPUT_MESSAGES = "gen_ai.input.messages";
public static final String LLM_OUTPUT_MESSAGES = "gen_ai.output.messages";
public static final String GEN_AI_INPUT_MESSAGES = "gen_ai.input.messages";

/** @deprecated Use {@link #GEN_AI_INPUT_MESSAGES}. */
@Deprecated
public static final String LLM_INPUT_MESSAGES = GEN_AI_INPUT_MESSAGES;
public static final String GEN_AI_OUTPUT_MESSAGES = "gen_ai.output.messages";

/** @deprecated Use {@link #GEN_AI_OUTPUT_MESSAGES}. */
@Deprecated
public static final String LLM_OUTPUT_MESSAGES = GEN_AI_OUTPUT_MESSAGES;
public static final String GEN_AI_SYSTEM_INSTRUCTIONS = "gen_ai.system_instructions";

// ── GenAI Tools ──────────────────────────────────────────────────
Expand Down
Loading
Loading