@idiomark/core 0.0.0-stage → 0.1.0

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 (138) hide show
  1. package/README.md +227 -2
  2. package/dist/activity-factory.d.ts +97 -0
  3. package/dist/activity-factory.d.ts.map +1 -0
  4. package/dist/activity-processor.d.ts +68 -0
  5. package/dist/activity-processor.d.ts.map +1 -0
  6. package/dist/adapters/base.d.ts +336 -0
  7. package/dist/adapters/base.d.ts.map +1 -0
  8. package/dist/adapters/index.d.ts +16 -0
  9. package/dist/adapters/index.d.ts.map +1 -0
  10. package/dist/adapters/index.mjs +1628 -0
  11. package/dist/adapters/index.mjs.map +1 -0
  12. package/dist/adapters/registry.d.ts +219 -0
  13. package/dist/adapters/registry.d.ts.map +1 -0
  14. package/dist/adapters/templates/rest.d.ts +151 -0
  15. package/dist/adapters/templates/rest.d.ts.map +1 -0
  16. package/dist/adapters/testing/index.d.ts +174 -0
  17. package/dist/adapters/testing/index.d.ts.map +1 -0
  18. package/dist/all-types.d.ts +6 -0
  19. package/dist/all-types.d.ts.map +1 -0
  20. package/dist/all-types.mjs +228 -0
  21. package/dist/all-types.mjs.map +1 -0
  22. package/dist/analyzer-dev.d.ts +104 -0
  23. package/dist/analyzer-dev.d.ts.map +1 -0
  24. package/dist/analyzer-nlp.d.ts +10 -0
  25. package/dist/analyzer-nlp.d.ts.map +1 -0
  26. package/dist/analyzer.d.ts +143 -0
  27. package/dist/analyzer.d.ts.map +1 -0
  28. package/dist/anticipatory/service.d.ts +106 -0
  29. package/dist/anticipatory/service.d.ts.map +1 -0
  30. package/dist/ast-analyzer.d.ts +139 -0
  31. package/dist/ast-analyzer.d.ts.map +1 -0
  32. package/dist/biometrics/types.d.ts +112 -0
  33. package/dist/biometrics/types.d.ts.map +1 -0
  34. package/dist/coordination/coordinator.d.ts +155 -0
  35. package/dist/coordination/coordinator.d.ts.map +1 -0
  36. package/dist/crypto/hash.d.ts +51 -0
  37. package/dist/crypto/hash.d.ts.map +1 -0
  38. package/dist/crypto/index.d.ts +19 -0
  39. package/dist/crypto/index.d.ts.map +1 -0
  40. package/dist/crypto/index.mjs +2416 -0
  41. package/dist/crypto/index.mjs.map +1 -0
  42. package/dist/crypto/key-provider/index.d.ts +31 -0
  43. package/dist/crypto/key-provider/index.d.ts.map +1 -0
  44. package/dist/crypto/key-provider/migration.d.ts +86 -0
  45. package/dist/crypto/key-provider/migration.d.ts.map +1 -0
  46. package/dist/crypto/key-provider/provider-factory.d.ts +47 -0
  47. package/dist/crypto/key-provider/provider-factory.d.ts.map +1 -0
  48. package/dist/crypto/key-provider/providers/aws-kms.d.ts +66 -0
  49. package/dist/crypto/key-provider/providers/aws-kms.d.ts.map +1 -0
  50. package/dist/crypto/key-provider/providers/azure-kv.d.ts +72 -0
  51. package/dist/crypto/key-provider/providers/azure-kv.d.ts.map +1 -0
  52. package/dist/crypto/key-provider/providers/softhsm.d.ts +74 -0
  53. package/dist/crypto/key-provider/providers/softhsm.d.ts.map +1 -0
  54. package/dist/crypto/key-provider/providers/vault.d.ts +66 -0
  55. package/dist/crypto/key-provider/providers/vault.d.ts.map +1 -0
  56. package/dist/crypto/key-provider/software-provider.d.ts +73 -0
  57. package/dist/crypto/key-provider/software-provider.d.ts.map +1 -0
  58. package/dist/crypto/key-provider/types.d.ts +232 -0
  59. package/dist/crypto/key-provider/types.d.ts.map +1 -0
  60. package/dist/crypto/post-quantum.d.ts +331 -0
  61. package/dist/crypto/post-quantum.d.ts.map +1 -0
  62. package/dist/crypto/random.d.ts +32 -0
  63. package/dist/crypto/random.d.ts.map +1 -0
  64. package/dist/crypto/ratchet.d.ts +231 -0
  65. package/dist/crypto/ratchet.d.ts.map +1 -0
  66. package/dist/crypto/symmetric.d.ts +43 -0
  67. package/dist/crypto/symmetric.d.ts.map +1 -0
  68. package/dist/extractor.d.ts +95 -0
  69. package/dist/extractor.d.ts.map +1 -0
  70. package/dist/generator.d.ts +119 -0
  71. package/dist/generator.d.ts.map +1 -0
  72. package/dist/idiomarkg-normalizer.d.ts +184 -0
  73. package/dist/idiomarkg-normalizer.d.ts.map +1 -0
  74. package/dist/index.d.ts +44 -0
  75. package/dist/index.d.ts.map +1 -0
  76. package/dist/index.mjs +11081 -0
  77. package/dist/index.mjs.map +1 -0
  78. package/dist/inference.d.ts +30 -0
  79. package/dist/inference.d.ts.map +1 -0
  80. package/dist/integration-dev.d.ts +164 -0
  81. package/dist/integration-dev.d.ts.map +1 -0
  82. package/dist/loader.d.ts +45 -0
  83. package/dist/loader.d.ts.map +1 -0
  84. package/dist/matching/matcher.d.ts +57 -0
  85. package/dist/matching/matcher.d.ts.map +1 -0
  86. package/dist/matching/similarity.d.ts +74 -0
  87. package/dist/matching/similarity.d.ts.map +1 -0
  88. package/dist/optimizer-idiomarkd.d.ts +77 -0
  89. package/dist/optimizer-idiomarkd.d.ts.map +1 -0
  90. package/dist/patterns/detector.d.ts +147 -0
  91. package/dist/patterns/detector.d.ts.map +1 -0
  92. package/dist/patterns/on-device.d.ts +163 -0
  93. package/dist/patterns/on-device.d.ts.map +1 -0
  94. package/dist/personality-prompt.d.ts +69 -0
  95. package/dist/personality-prompt.d.ts.map +1 -0
  96. package/dist/personality-prompt.mjs +390 -0
  97. package/dist/personality-prompt.mjs.map +1 -0
  98. package/dist/prompts-dev.d.ts +44 -0
  99. package/dist/prompts-dev.d.ts.map +1 -0
  100. package/dist/prompts.d.ts +45 -0
  101. package/dist/prompts.d.ts.map +1 -0
  102. package/dist/proximity/handshake.d.ts +185 -0
  103. package/dist/proximity/handshake.d.ts.map +1 -0
  104. package/dist/reader.d.ts +151 -0
  105. package/dist/reader.d.ts.map +1 -0
  106. package/dist/schema.d.ts +592 -0
  107. package/dist/schema.d.ts.map +1 -0
  108. package/dist/schemas-dev.d.ts +1277 -0
  109. package/dist/schemas-dev.d.ts.map +1 -0
  110. package/dist/security-idiomarkd.d.ts +95 -0
  111. package/dist/security-idiomarkd.d.ts.map +1 -0
  112. package/dist/types-activity.d.ts +1616 -0
  113. package/dist/types-activity.d.ts.map +1 -0
  114. package/dist/types-behavioral.d.ts +280 -0
  115. package/dist/types-behavioral.d.ts.map +1 -0
  116. package/dist/types-dev.d.ts +688 -0
  117. package/dist/types-dev.d.ts.map +1 -0
  118. package/dist/types-idiomarkf-jobs.d.ts +332 -0
  119. package/dist/types-idiomarkf-jobs.d.ts.map +1 -0
  120. package/dist/types-idiomarkf.d.ts +563 -0
  121. package/dist/types-idiomarkf.d.ts.map +1 -0
  122. package/dist/types-idiomarkg.d.ts +2884 -0
  123. package/dist/types-idiomarkg.d.ts.map +1 -0
  124. package/dist/types-mcl.d.ts +265 -0
  125. package/dist/types-mcl.d.ts.map +1 -0
  126. package/dist/types-robot.d.ts +283 -0
  127. package/dist/types-robot.d.ts.map +1 -0
  128. package/dist/types-v2.d.ts +210 -0
  129. package/dist/types-v2.d.ts.map +1 -0
  130. package/dist/types-v2.mjs +20 -0
  131. package/dist/types-v2.mjs.map +1 -0
  132. package/dist/types.d.ts +266 -0
  133. package/dist/types.d.ts.map +1 -0
  134. package/dist/validator-dev.d.ts +26 -0
  135. package/dist/validator-dev.d.ts.map +1 -0
  136. package/dist/validator.d.ts +15 -0
  137. package/dist/validator.d.ts.map +1 -0
  138. package/package.json +95 -5
package/README.md CHANGED
@@ -1,3 +1,228 @@
1
- # Temporary Holding Version
1
+ # @idiomark/core
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Core library for the Idiomark (Personality Characterization Protocol).
4
+
5
+ ## Features
6
+
7
+ - **Extraction** - Pull personality from platforms (GitHub, Twitter, Reddit, raw text)
8
+ - **Validation** - Verify Idiomark files against schema
9
+ - **Consumption** - Generate AI responses with personality injection
10
+ - **Inference Server** - HTTP API for personality-powered responses
11
+ - **V2 Experimental** - Enhanced personality dimensions (Big Five, linguistic markers, etc.)
12
+
13
+ ## Installation
14
+
15
+ ```bash
16
+ npm install @idiomark/core
17
+ ```
18
+
19
+ ## Quick Start
20
+
21
+ ### Extract a Personality
22
+
23
+ ```typescript
24
+ import { IdiomarkExtractor, extractFromTextString } from '@idiomark/core'
25
+
26
+ // From text strings
27
+ const result = await extractFromTextString([
28
+ "I love TypeScript!",
29
+ "TypeScript makes my code so much better.",
30
+ "The type system is incredible."
31
+ ], {
32
+ sources: ['text'],
33
+ verbose: true
34
+ })
35
+
36
+ // Save to file
37
+ await result.save('./my-personality.idiomark.json')
38
+ ```
39
+
40
+ ### Consume a Personality (Generate Responses)
41
+
42
+ ```typescript
43
+ import { IdiomarkReader, loadReader } from '@idiomark/core'
44
+
45
+ // Load a Idiomark file
46
+ const reader = await IdiomarkReader.fromFile('./my-personality.idiomark.json', {
47
+ provider: 'anthropic',
48
+ apiKey: process.env.ANTHROPIC_API_KEY
49
+ })
50
+
51
+ // Generate a response
52
+ const response = await reader.respond("What's your opinion on React?")
53
+ console.log(response.content)
54
+
55
+ // Interactive chat
56
+ await reader.chat(async (input) => input)
57
+ ```
58
+
59
+ ### V2 Enhanced Personality (Experimental)
60
+
61
+ ```typescript
62
+ import { loadReader, buildResponsePromptFromIdiomarkFile } from '@idiomark/core'
63
+
64
+ // Load a Idiomark file with V2 data
65
+ const reader = await loadReader('./my-personality-v2.idiomark.json')
66
+
67
+ // V2 personality includes Big Five, linguistic markers, etc.
68
+ const response = await reader.respond("How do you approach problems?")
69
+ ```
70
+
71
+ **See [V2_USAGE.md](../../docs/V2_USAGE.md) for complete V2 documentation.**
72
+
73
+ ## Configuration
74
+
75
+ ### Defaults (Optimized for GLM MAX / z.ai)
76
+
77
+ The library is optimized by default for **GLM MAX coding plan** with z.ai:
78
+
79
+ | Setting | Default | Notes |
80
+ |----------|----------|-------|
81
+ | `maxTokens` | 131,072 (both) | GLM-4.7 max output |
82
+ | `chunkSize` | 200,000 chars | Matches GLM context window |
83
+
84
+ These defaults maximize throughput when rate limited by **request count** rather than tokens.
85
+
86
+ ### Optional Environment Variables
87
+
88
+ Override defaults if needed:
89
+
90
+ | Variable | Description |
91
+ |----------|-------------|
92
+ | `Idiomark_MAX_TOKENS` | Override default max output tokens |
93
+ | `Idiomark_CHUNK_SIZE` | Override default chunk size threshold |
94
+ | `ANTHROPIC_API_KEY` | API key for Anthropic Claude |
95
+ | `OPENAI_API_KEY` | API key for OpenAI GPT models |
96
+
97
+ **Only use env vars if you need different behavior than the optimized defaults.**
98
+
99
+ ## API Reference
100
+
101
+ ### Extraction
102
+
103
+ | Class/Function | Description |
104
+ |----------------|-------------|
105
+ | `IdiomarkExtractor` | Main extraction class |
106
+ | `extractFromTextString(text)` | Quick extraction from single text |
107
+ | `extractFromTextStrings(texts[])` | Extract from multiple texts |
108
+ | `extractFromPlatforms(config)` | Extract from platform adapters |
109
+
110
+ ### Consumption
111
+
112
+ | Class/Function | Description |
113
+ |----------------|-------------|
114
+ | `IdiomarkReader` | Main personality consumer class |
115
+ | `loadReader(path)` | Load Idiomark file and create reader |
116
+ | `createReader(personality)` | Create reader from personality object |
117
+ | `generateResponse(personality, message)` | One-off response generation |
118
+
119
+ ### Validation
120
+
121
+ | Class/Function | Description |
122
+ |----------------|-------------|
123
+ | `IdiomarkValidator` | Validate Idiomark files against schema |
124
+
125
+ ### Prompt Building
126
+
127
+ | Function | Description |
128
+ |----------|-------------|
129
+ | `buildSystemPrompt(personality)` | Build system prompt from V1 personality |
130
+ | `buildSystemPromptV2(personalityV2)` | Build enhanced prompt with V2 dimensions |
131
+ | `buildResponsePromptFromIdiomarkFile(idiomarkFile, message)` | Auto-detects and uses V2 or V1 |
132
+
133
+ ### File Operations
134
+
135
+ | Function | Description |
136
+ |----------|-------------|
137
+ | `loadIdiomarkFile(path)` | Load and validate a Idiomark file |
138
+ | `loadIdiomarkById(directory, id)` | Load Idiomark file by ID from directory |
139
+ | `listIdiomarkFiles(directory)` | List all Idiomark files in directory |
140
+ | `writeIdiomarkFile(path, file)` | Write Idiomark file to disk |
141
+ | `deleteIdiomarkFile(path)` | Delete a Idiomark file |
142
+
143
+ ## Types
144
+
145
+ ### Core Types
146
+
147
+ ```typescript
148
+ interface IdiomarkFile {
149
+ idiomark: string // Version: "1.0.0", "2.0.0-beta"
150
+ id: string
151
+ created: string
152
+ updated: string
153
+ metadata: IdiomarkMetadata
154
+ personality: Personality // V1 core (stable)
155
+ personality_v2?: PersonalityV2 // V2 experimental (optional)
156
+ }
157
+
158
+ interface Personality {
159
+ voice: Voice
160
+ patterns: Patterns
161
+ domains: Domain[]
162
+ values: Value[]
163
+ knowledge: Knowledge
164
+ }
165
+ ```
166
+
167
+ ### V2 Experimental Types
168
+
169
+ ```typescript
170
+ interface PersonalityV2 {
171
+ // V1 core (always included)
172
+ voice: Voice
173
+ patterns: Patterns
174
+ domains: Domain[]
175
+ values: Value[]
176
+ knowledge: Knowledge
177
+
178
+ // V2 experimental dimensions
179
+ big_five?: BigFiveTraits
180
+ linguistic_markers?: LinguisticMarkers
181
+ communication_style?: CommunicationStyle
182
+ cognitive_patterns?: CognitivePatterns
183
+ emotional_patterns?: EmotionalPatterns
184
+ social_dynamics?: SocialDynamics
185
+ }
186
+ ```
187
+
188
+ **See [types-v2.ts](./src/types-v2.ts) for complete V2 type definitions.**
189
+
190
+ ## Inference Server
191
+
192
+ ```typescript
193
+ import { IdiomarkInferenceServer } from '@idiomark/core'
194
+
195
+ const server = new IdiomarkInferenceServer({
196
+ port: 3000,
197
+ model: 'claude-3-5-sonnet-20241022',
198
+ personality: idiomarkFile,
199
+ generation: {
200
+ provider: 'anthropic',
201
+ apiKey: process.env.ANTHROPIC_API_KEY
202
+ }
203
+ })
204
+
205
+ await server.start()
206
+ // Server now running at http://localhost:3000
207
+ ```
208
+
209
+ ### Server Endpoints
210
+
211
+ | Endpoint | Method | Description |
212
+ |----------|----------|-------------|
213
+ | `POST /generate` | Generate response with personality |
214
+ | `POST /stream` | Stream response (SSE) |
215
+ | `GET /health` | Health check |
216
+ | `GET /personality` | View loaded personality |
217
+ | `GET /system-prompt` | View system prompt |
218
+
219
+ ## Examples
220
+
221
+ See [examples/](./examples/) directory for:
222
+
223
+ - [consume-idiomark.ts](./examples/consume-idiomark.ts) - Personality consumption examples
224
+ - [analyze-text.example.ts](./examples/analyze-text.example.ts) - Text analysis examples
225
+
226
+ ## License
227
+
228
+ MIT
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Activity Event Factory
3
+ *
4
+ * Factory functions for creating activity events with proper IDs and timestamps
5
+ *
6
+ * @module activity-factory
7
+ */
8
+ import type { RawActivityEvent, IdiomarkGActivityEvent, GamingContext, ActivityVerb } from './types-activity';
9
+ /**
10
+ * Get current timestamp in microseconds
11
+ */
12
+ export declare function getMicroseconds(): number;
13
+ /**
14
+ * Convert Date to microseconds
15
+ */
16
+ export declare function dateToMicroseconds(date: Date): number;
17
+ /**
18
+ * Convert microseconds to Date
19
+ */
20
+ export declare function microsecondsToDate(micros: number): Date;
21
+ /**
22
+ * Generate a UUID v7 (time-sortable)
23
+ *
24
+ * Note: This is a simplified implementation. For production, use a proper UUID v7 library.
25
+ * Format: tttttttt-tttt-7xxx-yxxx-xxxxxxxxxxxx
26
+ * - t: timestamp (48 bits, milliseconds since epoch)
27
+ * - x: random bits
28
+ * - y: version (4 for random, we use 7 for v7)
29
+ */
30
+ export declare function generateUUIDv7(): string;
31
+ /**
32
+ * Options for creating an activity event
33
+ */
34
+ export interface CreateActivityEventOptions {
35
+ verb: ActivityVerb;
36
+ object: string;
37
+ actor?: string;
38
+ context?: Record<string, unknown>;
39
+ ttl?: number;
40
+ timestamp?: number;
41
+ id?: string;
42
+ }
43
+ /**
44
+ * Create a raw activity event
45
+ */
46
+ export declare function createActivityEvent(options: CreateActivityEventOptions): RawActivityEvent;
47
+ /**
48
+ * Options for creating a gaming activity event
49
+ */
50
+ export interface CreateGamingEventOptions {
51
+ verb: IdiomarkGActivityEvent['verb'];
52
+ object: string;
53
+ context?: GamingContext;
54
+ ttl?: number;
55
+ timestamp?: number;
56
+ id?: string;
57
+ }
58
+ /**
59
+ * Create a IdiomarkG gaming activity event
60
+ */
61
+ export declare function createGamingEvent(options: CreateGamingEventOptions): IdiomarkGActivityEvent;
62
+ /**
63
+ * Create a "game played" event
64
+ */
65
+ export declare function gamePlayed(gameId: string, gameName: string, options?: {
66
+ playtimeMinutes?: number;
67
+ genre?: string;
68
+ platform?: string;
69
+ }): IdiomarkGActivityEvent;
70
+ /**
71
+ * Create a "match completed" event
72
+ */
73
+ export declare function matchCompleted(gameId: string, result: 'win' | 'loss' | 'draw', options?: {
74
+ score?: number;
75
+ position?: number;
76
+ playtimeMinutes?: number;
77
+ }): IdiomarkGActivityEvent;
78
+ /**
79
+ * Create an "achievement unlocked" event
80
+ */
81
+ export declare function achievementUnlocked(gameId: string, achievementId: string, options?: {
82
+ achievementName?: string;
83
+ rarity?: number;
84
+ }): IdiomarkGActivityEvent;
85
+ /**
86
+ * Create a "rank changed" event
87
+ */
88
+ export declare function rankChanged(gameId: string, newRank: string, options?: {
89
+ oldRank?: string;
90
+ }): IdiomarkGActivityEvent;
91
+ /**
92
+ * Create a "friend added" event
93
+ */
94
+ export declare function friendAdded(platformId: string, options?: {
95
+ gameId?: string;
96
+ }): IdiomarkGActivityEvent;
97
+ //# sourceMappingURL=activity-factory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activity-factory.d.ts","sourceRoot":"","sources":["../src/activity-factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAA;AAMzB;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAErD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEvD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,MAAM,CA0BvC;AAMD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,gBAAgB,CAqBzF;AAMD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,sBAAsB,CAiB3F;AAMD;;GAEG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;CACb,GACL,sBAAsB,CAYxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,EAC/B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAA;CACpB,GACL,sBAAsB,CAYxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACP,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,sBAAsB,CAaxB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAA;CACZ,GACL,sBAAsB,CAYxB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,sBAAsB,CAMxB"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * IdiomarkG Activity Processor
3
+ *
4
+ * Processes activity events and incrementally updates IdiomarkG profiles.
5
+ * Inspired by game AI patterns for incremental state updates.
6
+ *
7
+ * @module activity-processor
8
+ */
9
+ import type { IdiomarkGGaming } from './types-idiomarkg';
10
+ import type { IdiomarkGActivityEvent } from './types-activity';
11
+ /**
12
+ * Configuration for activity processing
13
+ */
14
+ export interface ActivityProcessorConfig {
15
+ /**
16
+ * How much each event affects personality scores (0-1)
17
+ * Lower = slower adaptation, Higher = faster adaptation
18
+ */
19
+ adaptationRate: number;
20
+ /**
21
+ * Maximum change per event (capped)
22
+ */
23
+ maxDeltaPerEvent: number;
24
+ /**
25
+ * Whether to apply decay to older traits
26
+ */
27
+ enableDecay: boolean;
28
+ /**
29
+ * Decay factor per event (0-1)
30
+ * Only applies if enableDecay is true
31
+ */
32
+ decayFactor: number;
33
+ }
34
+ /**
35
+ * Processes IdiomarkG activity events and updates profiles incrementally
36
+ *
37
+ * Inspired by game AI patterns:
38
+ * - Incremental state updates (not full rebuilds)
39
+ * - Event-driven personality evolution
40
+ * - Trend tracking over time
41
+ */
42
+ export declare class IdiomarkGActivityProcessor {
43
+ private config;
44
+ constructor(config?: Partial<ActivityProcessorConfig>);
45
+ /**
46
+ * Process a single activity event and return updated profile
47
+ */
48
+ processEvent(event: IdiomarkGActivityEvent, currentProfile: IdiomarkGGaming): IdiomarkGGaming;
49
+ /**
50
+ * Process multiple events in sequence
51
+ */
52
+ processEvents(events: IdiomarkGActivityEvent[], initialProfile: IdiomarkGGaming): IdiomarkGGaming;
53
+ private processGamePlayed;
54
+ private processMatchCompleted;
55
+ private processAchievementUnlocked;
56
+ private processRankChanged;
57
+ private processFriendAdded;
58
+ /**
59
+ * Calculate the delta to apply based on current value and target
60
+ */
61
+ private calculateDelta;
62
+ /**
63
+ * Clamp a value to 0-1 range
64
+ */
65
+ private clamp;
66
+ }
67
+ export declare const idiomarkgActivityProcessor: IdiomarkGActivityProcessor;
68
+ //# sourceMappingURL=activity-processor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activity-processor.d.ts","sourceRoot":"","sources":["../src/activity-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAa,MAAM,mBAAmB,CAAA;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAuC9D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAA;IAEpB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAA;CACpB;AAaD;;;;;;;GAOG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,MAAM,CAAyB;gBAE3B,MAAM,GAAE,OAAO,CAAC,uBAAuB,CAAM;IAIzD;;OAEG;IACH,YAAY,CACV,KAAK,EAAE,sBAAsB,EAC7B,cAAc,EAAE,eAAe,GAC9B,eAAe;IA4BlB;;OAEG;IACH,aAAa,CACX,MAAM,EAAE,sBAAsB,EAAE,EAChC,cAAc,EAAE,eAAe,GAC9B,eAAe;IAclB,OAAO,CAAC,iBAAiB;IA6BzB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,0BAA0B;IAyClC,OAAO,CAAC,kBAAkB;IAyB1B,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAMD,eAAO,MAAM,0BAA0B,4BAAmC,CAAA"}