@pinta-ai/types 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/dist/cdm.d.ts +81 -0
  2. package/dist/cdm.d.ts.map +1 -0
  3. package/dist/cdm.js +13 -0
  4. package/dist/cdm.js.map +1 -0
  5. package/dist/index.d.ts +2 -1
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/ingest.d.ts +17 -21
  8. package/dist/ingest.d.ts.map +1 -1
  9. package/package.json +1 -1
package/dist/cdm.d.ts ADDED
@@ -0,0 +1,81 @@
1
+ /**
2
+ * CDM (Common Data Model) Types
3
+ *
4
+ * Adaptor 무관한 공통 스키마 정의.
5
+ * Silver 레이어에서 사용하는 정규화된 데이터 구조.
6
+ *
7
+ * 설계 원칙:
8
+ * - 분류 차원(category/kind/action/outcome)은 느슨한 의미 분류 (집계용)
9
+ * - source.event로 원본 이벤트를 정확히 식별 (디버깅용)
10
+ * - 저장소는 enum을 모름 (string으로 저장, enum 추가 시 스키마 변경 없음)
11
+ */
12
+ export type CDMCategory = 'execution' | 'access' | 'communication' | 'lifecycle';
13
+ export type CDMKind = 'tool' | 'resource' | 'prompt' | 'response' | 'agent' | 'session';
14
+ export type CDMAction = 'invoke' | 'read' | 'write' | 'list' | 'create' | 'destroy' | 'delegate' | 'start' | 'end' | 'subscribe' | 'unsubscribe' | 'configure' | 'ping' | 'cancel' | 'progress' | 'change';
15
+ export type CDMOutcome = 'success' | 'failure' | 'blocked' | 'timeout' | 'unknown';
16
+ export interface CDMToolFields {
17
+ 'tool.name'?: string;
18
+ 'tool.input'?: string;
19
+ 'tool.input_size'?: number;
20
+ 'tool.output'?: string;
21
+ 'tool.output_size'?: number;
22
+ }
23
+ export interface CDMResourceFields {
24
+ 'resource.uri'?: string;
25
+ 'resource.type'?: string;
26
+ 'resource.size'?: number;
27
+ 'resource.mime_type'?: string;
28
+ }
29
+ export interface CDMMessageFields {
30
+ 'message.role'?: string;
31
+ 'message.content'?: string;
32
+ 'message.content_size'?: number;
33
+ 'message.token_count'?: number;
34
+ }
35
+ export interface CDMDelegateFields {
36
+ 'delegate.agent_id'?: string;
37
+ 'delegate.agent_type'?: string;
38
+ }
39
+ export interface CDMErrorFields {
40
+ 'error.code'?: string;
41
+ 'error.message'?: string;
42
+ 'error.reason'?: string;
43
+ }
44
+ export interface CDMSecurityFields {
45
+ 'permission.level'?: string;
46
+ }
47
+ export interface CDMBillingFields {
48
+ 'cost'?: number;
49
+ }
50
+ export interface CDMHostFields {
51
+ 'host.name'?: string;
52
+ 'process.owner'?: string;
53
+ }
54
+ export interface CDMRecord extends CDMToolFields, CDMResourceFields, CDMMessageFields, CDMDelegateFields, CDMErrorFields, CDMSecurityFields, CDMBillingFields, CDMHostFields {
55
+ 'record.id': string;
56
+ 'record.timestamp': number;
57
+ 'record.duration_ms'?: number;
58
+ 'record.category': CDMCategory;
59
+ 'record.kind': CDMKind;
60
+ 'record.action': CDMAction;
61
+ 'record.outcome': CDMOutcome;
62
+ 'trace.id': string;
63
+ 'span.id': string;
64
+ 'span.parent_id'?: string;
65
+ 'session.id'?: string;
66
+ 'conversation.id'?: string;
67
+ 'memberIdentity.id'?: string;
68
+ 'memberIdentity.email'?: string;
69
+ 'client.name'?: string;
70
+ 'client.version'?: string;
71
+ 'agent.name'?: string;
72
+ 'agent.version'?: string;
73
+ 'source.adaptor': string;
74
+ 'source.event': string;
75
+ 'source.raw_id': string;
76
+ 'source.transport'?: string;
77
+ 'org.id': string;
78
+ extra?: string;
79
+ }
80
+ export type SourceAdaptor = 'mcp-logger' | 'pinta-cc';
81
+ //# sourceMappingURL=cdm.d.ts.map
package/dist/cdm.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cdm.d.ts","sourceRoot":"","sources":["../src/cdm.ts"],"names":[],"mappings":"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"}
package/dist/cdm.js ADDED
@@ -0,0 +1,13 @@
1
+ /**
2
+ * CDM (Common Data Model) Types
3
+ *
4
+ * Adaptor 무관한 공통 스키마 정의.
5
+ * Silver 레이어에서 사용하는 정규화된 데이터 구조.
6
+ *
7
+ * 설계 원칙:
8
+ * - 분류 차원(category/kind/action/outcome)은 느슨한 의미 분류 (집계용)
9
+ * - source.event로 원본 이벤트를 정확히 식별 (디버깅용)
10
+ * - 저장소는 enum을 모름 (string으로 저장, enum 추가 시 스키마 변경 없음)
11
+ */
12
+ export {};
13
+ //# sourceMappingURL=cdm.js.map
package/dist/cdm.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cdm.js","sourceRoot":"","sources":["../src/cdm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}
package/dist/index.d.ts CHANGED
@@ -1,2 +1,3 @@
1
- export type { IngestTypeMap, IngestType, MCPSpan, } from './ingest.js';
1
+ export type { IngestTypeMap, IngestType, MCPSpan, MemberIdentity, } from './ingest.js';
2
+ export type { CDMCategory, CDMKind, CDMAction, CDMOutcome, CDMToolFields, CDMResourceFields, CDMMessageFields, CDMDelegateFields, CDMErrorFields, CDMSecurityFields, CDMBillingFields, CDMHostFields, CDMRecord, SourceAdaptor, } from './cdm.js';
2
3
  //# sourceMappingURL=index.d.ts.map
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,UAAU,EACV,OAAO,GACR,MAAM,aAAa,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,UAAU,EACV,OAAO,EACP,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,OAAO,EACP,SAAS,EACT,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,aAAa,GACd,MAAM,UAAU,CAAC"}
package/dist/ingest.d.ts CHANGED
@@ -17,57 +17,53 @@ export interface IngestTypeMap {
17
17
  */
18
18
  export type IngestType = keyof IngestTypeMap;
19
19
  /**
20
- * MCP adapter가 전송하는 span attribute 인터페이스.
20
+ * MCP adaptor가 전송하는 raw span attribute 인터페이스 (bronze 형태).
21
+ *
22
+ * Phase B 이후 adaptor는 semantic 추출(tool.name, resource.*, size 등)을 하지 않는다.
23
+ * aware-backend가 Silver 파이프라인에서 `mcp.request.params` / `mcp.response.result`를
24
+ * 파싱해 CDM으로 변환한다.
21
25
  *
22
26
  * OTel span attributes로 직렬화되므로 flat key-value 구조.
23
27
  * mcp.type으로 span 종류를 구분:
24
28
  * - paired: request + response 매칭된 쌍 (duration 포함)
25
29
  * - request: 응답 없이 타임아웃된 요청
26
30
  * - response: 요청 없이 수신된 응답
27
- * - notification: ID 없는 단방향 알림 (client→server 또는 server→client)
31
+ * - notification: ID 없는 단방향 알림
28
32
  */
29
33
  export interface MCPSpan {
30
34
  'ingest.type': 'mcp';
31
35
  'mcp.type': 'paired' | 'request' | 'response' | 'notification';
32
36
  'mcp.transport': 'stdio' | 'sse';
33
37
  'mcp.method': string;
34
- /** @deprecated backend 호환용. 향후 제거 예정. */
35
- 'mcp.source'?: 'cli' | 'sdk';
36
- /** @deprecated backend 호환용. 향후 제거 예정. 우리가 조합하는 값. */
37
- 'mcp.trace.id'?: string;
38
38
  'mcp.request.id'?: string;
39
39
  'mcp.request.method'?: string;
40
40
  'mcp.request.timestamp'?: number;
41
41
  'mcp.request.params'?: string;
42
- 'mcp.request.params.size'?: number;
43
42
  'mcp.response.id'?: string;
44
43
  'mcp.response.method'?: string;
45
44
  'mcp.response.timestamp'?: number;
46
45
  'mcp.response.result'?: string;
47
- 'mcp.response.result.size'?: number;
48
46
  'mcp.duration_ms'?: number;
49
- 'mcp.tool.name'?: string;
50
- 'mcp.tool.arguments'?: string;
51
- 'mcp.tool.arguments.size'?: number;
52
47
  'mcp.error'?: boolean;
53
48
  'mcp.error.code'?: number;
54
49
  'mcp.error.message'?: string;
50
+ 'mcp.headers'?: string;
51
+ 'mcp.cli'?: string;
52
+ 'mcp.events'?: string;
53
+ 'mcp.events.count'?: number;
54
+ 'mcp.sdk.name'?: string;
55
+ 'mcp.sdk.version'?: string;
55
56
  'mcp.session.id'?: string;
56
57
  'mcp.conversation.id'?: string;
57
58
  'mcp.user.id'?: string;
58
59
  'mcp.client.name'?: string;
59
60
  'mcp.client.version'?: string;
60
- 'mcp.sdk.name'?: string;
61
- 'mcp.sdk.version'?: string;
62
- 'mcp.cli'?: string;
63
- 'mcp.headers'?: string;
64
- 'mcp.headers.size'?: number;
65
- 'mcp.events'?: string;
66
- 'mcp.events.count'?: number;
67
- 'mcp.resource.type'?: string;
68
- 'mcp.resource.uri'?: string;
69
- 'mcp.resource.access_count'?: number;
70
61
  'mcp.permission.level'?: string;
71
62
  'mcp.cost'?: number;
72
63
  }
64
+ /** Resource-level member identity attributes */
65
+ export interface MemberIdentity {
66
+ 'member.identity.id'?: string;
67
+ 'member.identity.email'?: string;
68
+ }
73
69
  //# sourceMappingURL=ingest.d.ts.map
package/dist/ingest.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC;AAM7C;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IAEtB,aAAa,EAAE,KAAK,CAAC;IAGrB,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,cAAc,CAAC;IAC/D,eAAe,EAAE,OAAO,GAAG,KAAK,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IAErB,yCAAyC;IACzC,YAAY,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAC7B,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAGpC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAGnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAG5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAGrC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
1
+ {"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../src/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC;AAM7C;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,OAAO;IAEtB,aAAa,EAAE,KAAK,CAAC;IAGrB,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,cAAc,CAAC;IAC/D,eAAe,EAAE,OAAO,GAAG,KAAK,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IAGrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAG/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAG9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pinta-ai/types",
3
- "version": "0.0.3",
3
+ "version": "0.0.5",
4
4
  "description": "Shared type definitions for Pinta AI adapters and log processing server",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",