@harnessforce/semconv 0.0.0-stage → 0.1.0

package/dist/schemas/session-usage-summary.d.ts

@@ -0,0 +1,57 @@
+import { type Static } from "@sinclair/typebox";
+export declare const SessionUsageSummarySchema: import("@sinclair/typebox").TObject<{
+    agent: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"claude_code">, import("@sinclair/typebox").TLiteral<"codex">]>;
+    session_id: import("@sinclair/typebox").TString;
+    first_prompt_id: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    started_at: import("@sinclair/typebox").TString;
+    last_event_at: import("@sinclair/typebox").TString;
+    collector_version: import("@sinclair/typebox").TString;
+    skills: import("@sinclair/typebox").TObject<{
+        items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            name: import("@sinclair/typebox").TString;
+            calls: import("@sinclair/typebox").TInteger;
+            failures: import("@sinclair/typebox").TInteger;
+        }>>;
+        other: import("@sinclair/typebox").TObject<{
+            calls: import("@sinclair/typebox").TInteger;
+            failures: import("@sinclair/typebox").TInteger;
+        }>;
+    }>;
+    commands: import("@sinclair/typebox").TObject<{
+        items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            name: import("@sinclair/typebox").TString;
+            calls: import("@sinclair/typebox").TInteger;
+        }>>;
+        other: import("@sinclair/typebox").TObject<{
+            calls: import("@sinclair/typebox").TInteger;
+        }>;
+    }>;
+    subagents: import("@sinclair/typebox").TObject<{
+        items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            name: import("@sinclair/typebox").TString;
+            calls: import("@sinclair/typebox").TInteger;
+            failures: import("@sinclair/typebox").TInteger;
+        }>>;
+        other: import("@sinclair/typebox").TObject<{
+            calls: import("@sinclair/typebox").TInteger;
+            failures: import("@sinclair/typebox").TInteger;
+        }>;
+    }>;
+    mcp_servers: import("@sinclair/typebox").TObject<{
+        items: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            name: import("@sinclair/typebox").TString;
+            calls: import("@sinclair/typebox").TInteger;
+            failures: import("@sinclair/typebox").TInteger;
+        }>>;
+        other: import("@sinclair/typebox").TObject<{
+            calls: import("@sinclair/typebox").TInteger;
+            failures: import("@sinclair/typebox").TInteger;
+        }>;
+    }>;
+    permission_requests: import("@sinclair/typebox").TInteger;
+    compactions: import("@sinclair/typebox").TObject<{
+        auto: import("@sinclair/typebox").TInteger;
+        manual: import("@sinclair/typebox").TInteger;
+    }>;
+}>;
+export type SessionUsageSummary = Static<typeof SessionUsageSummarySchema>;

package/dist/schemas/session-usage-summary.js

@@ -0,0 +1,32 @@
+import { Type } from "@sinclair/typebox";
+import { Agent, Count, closed, Instant, SemVer, schemaId, Token, } from "./common.js";
+const Calls = Type.Integer({ minimum: 1 });
+// semantic-conventions.md「Session usage summary」: 1つの一覧のitemsの上限。残りはotherへ加える。
+const limited = { maxItems: 200 };
+// skills、subagents、mcp_serversの一覧。
+const CallList = Type.Object({
+    items: Type.Array(Type.Object({ name: Token(), calls: Calls, failures: Count }, closed), limited),
+    other: Type.Object({ calls: Count, failures: Count }, closed),
+}, closed);
+// commandの展開には失敗の記録が無いため、0と数えた失敗を持たない。
+const CommandList = Type.Object({
+    items: Type.Array(Type.Object({ name: Token(), calls: Calls }, closed), limited),
+    other: Type.Object({ calls: Count }, closed),
+}, closed);
+// itemsのnameの重複、failuresがcallsを超える値、started_atがlast_event_atより後の値もschema違反だが、
+// JSON Schemaでは表せないため、受け取る側が別に確かめる。
+export const SessionUsageSummarySchema = Type.Object({
+    agent: Agent,
+    session_id: Token(),
+    first_prompt_id: Type.Optional(Token()),
+    started_at: Instant,
+    last_event_at: Instant,
+    collector_version: SemVer,
+    skills: CallList,
+    commands: CommandList,
+    subagents: CallList,
+    mcp_servers: CallList,
+    permission_requests: Count,
+    compactions: Type.Object({ auto: Count, manual: Count }, closed),
+}, { $id: schemaId("session-usage-summary"), ...closed });
+//# sourceMappingURL=session-usage-summary.js.map

package/dist/schemas/session-usage-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-usage-summary.js","sourceRoot":"","sources":["../../src/schemas/session-usage-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACN,KAAK,EACL,KAAK,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,QAAQ,EACR,KAAK,GACL,MAAM,aAAa,CAAC;AAErB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;AAC3C,+EAA+E;AAC/E,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AAElC,mCAAmC;AACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAC3B;IACC,KAAK,EAAE,IAAI,CAAC,KAAK,CAChB,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,EACrE,OAAO,CACP;IACD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC;CAC7D,EACD,MAAM,CACN,CAAC;AAEF,uCAAuC;AACvC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAC9B;IACC,KAAK,EAAE,IAAI,CAAC,KAAK,CAChB,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,EACpD,OAAO,CACP;IACD,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC;CAC5C,EACD,MAAM,CACN,CAAC;AAEF,8EAA8E;AAC9E,oCAAoC;AACpC,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,MAAM,CACnD;IACC,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,KAAK,EAAE;IACnB,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACvC,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,OAAO;IACtB,iBAAiB,EAAE,MAAM;IACzB,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,QAAQ;IACrB,mBAAmB,EAAE,KAAK;IAC1B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC;CAChE,EACD,EAAE,GAAG,EAAE,QAAQ,CAAC,uBAAuB,CAAC,EAAE,GAAG,MAAM,EAAE,CACrD,CAAC"}

package/dist/values.d.ts

@@ -0,0 +1,4 @@
+export declare const TOKEN_PATTERN = "^[^\\t-\\r \\u0085\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000]+$";
+export declare const isToken: (value: string, maxLength?: number) => boolean;
+export declare const INSTANT_PATTERN = "^(?:1(?:6(?:7[7-9]|[89]\\d)|[7-9]\\d\\d)|2(?:[01]\\d\\d|2(?:[0-5]\\d|6[0-2])))-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$";
+export declare function isInstant(value: string): boolean;

package/dist/values.js

@@ -0,0 +1,52 @@
+// schemaの値の形（semantic-conventions.md「値の形」）を、TypeBoxに依存せずに表す。
+// hookのbundleがschemaの実装を読み込まずに使えるよう、schemasから分けて置く。
+// semantic-conventions.md「値の形」のtoken。Unicodeの`White_Space` propertyを持つ文字の一覧であり、JSの\sと違い
+// U+0085を含みU+FEFFを含まない。u flagの有無に依らず同じに解釈されるよう、BMPの文字の範囲だけで書く。
+const WHITE_SPACE = "\\t-\\r \\u0085\\u00a0\\u1680\\u2000-\\u200a\\u2028\\u2029\\u202f\\u205f\\u3000";
+export const TOKEN_PATTERN = `^[^${WHITE_SPACE}]+$`;
+const NO_WHITE_SPACE = new RegExp(TOKEN_PATTERN);
+// Tokenと同じ制約を、schemaをcompileせずに確かめる。文字数はcode pointで数える。
+export const isToken = (value, maxLength = 256) => {
+    const length = [...value].length;
+    return length >= 1 && length <= maxLength && NO_WHITE_SPACE.test(value);
+};
+// semantic-conventions.md「値の形」のinstant。APIはoffsetの無い日時を受け付けない。format(date-time)だけでは
+// 実装によりoffsetが任意になるため、patternでoffsetの範囲（hhは00〜23、mmは00〜59）と年（1677〜2262）も固定する。
+// JSON Schemaはoffsetを引いた瞬間を比べられないため、境界の年の中の範囲はisInstantが確かめる。
+const INSTANT_YEAR = "(?:1(?:6(?:7[7-9]|[89]\\d)|[7-9]\\d\\d)|2(?:[01]\\d\\d|2(?:[0-5]\\d|6[0-2])))";
+export const INSTANT_PATTERN = `^${INSTANT_YEAR}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d)$`;
+// INSTANT_PATTERNを通った値から、各部分を取り出す。
+const INSTANT_PARTS = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d+))?(?:Z|([+-])(\d{2}):(\d{2}))$/;
+const INSTANT = new RegExp(INSTANT_PATTERN);
+// DateTime64(9)で表せる範囲（ClickHouse reference）。両端を含む。
+const MIN_INSTANT_MS = Date.UTC(1677, 8, 21, 0, 12, 44);
+const MAX_INSTANT_MS = Date.UTC(2262, 3, 11, 23, 47, 16);
+// 暦に存在する日時で、offsetを引いた瞬間が範囲内かを確かめる。小数秒は9桁より下を切り捨てて比べる。
+export function isInstant(value) {
+    const parts = INSTANT.test(value) ? INSTANT_PARTS.exec(value) : null;
+    if (!parts)
+        return false;
+    const [, ...fields] = parts;
+    const [year, month, day, hour, minute, second] = fields
+        .slice(0, 6)
+        .map(Number);
+    const [fraction = "", sign, offsetHours = "0", offsetMinutes = "0"] = fields.slice(6);
+    const localMs = Date.UTC(year, month - 1, day, hour, minute, second);
+    const local = new Date(localMs);
+    const existsInCalendar = local.getUTCFullYear() === year &&
+        local.getUTCMonth() === month - 1 &&
+        local.getUTCDate() === day &&
+        local.getUTCHours() === hour &&
+        local.getUTCMinutes() === minute &&
+        local.getUTCSeconds() === second;
+    if (!existsInCalendar)
+        return false;
+    const offsetMs = (sign === "-" ? -1 : 1) *
+        (Number(offsetHours) * 60 + Number(offsetMinutes)) *
+        60_000;
+    const secondMs = localMs - offsetMs;
+    const nanos = Number(fraction.slice(0, 9) || "0");
+    const isAfterMax = secondMs > MAX_INSTANT_MS || (secondMs === MAX_INSTANT_MS && nanos > 0);
+    return secondMs >= MIN_INSTANT_MS && !isAfterMax;
+}
+//# sourceMappingURL=values.js.map

package/dist/values.js.map

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

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@harnessforce/semconv",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Harnessforce semantic conventions: hf.* attributes and ingest JSON Schemas",
+  "keywords": [
+    "harnessforce",
+    "opentelemetry",
+    "semantic-conventions",
+    "json-schema",
+    "typebox"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/lambda-script/harnessforce-agent/tree/main/packages/semconv#readme",
+  "bugs": {
+    "url": "https://github.com/lambda-script/harnessforce-agent/issues"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lambda-script/harnessforce-agent.git",
+    "directory": "packages/semconv"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.52"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.14",
+    "@types/node": "^22.20.4",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11",
+    "@harnessforce/test-support": "0.0.0"
+  },
+  "scripts": {
+    "lint": "biome check .",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "build": "tsc -p tsconfig.build.json"
+  }
 }