coaiajs 0.2.1 → 0.3.1

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 (172) hide show
  1. package/KINSHIP.md +1 -1
  2. package/README.md +191 -75
  3. package/dist/mcp/config.d.ts.map +1 -0
  4. package/dist/mcp/config.js +0 -2
  5. package/dist/mcp/config.js.map +1 -0
  6. package/dist/mcp/prompts.d.ts.map +1 -0
  7. package/dist/mcp/prompts.js.map +1 -0
  8. package/dist/mcp/resources.d.ts.map +1 -0
  9. package/dist/mcp/resources.js.map +1 -0
  10. package/dist/mcp/server.d.ts.map +1 -0
  11. package/dist/mcp/server.js +3 -2
  12. package/dist/mcp/server.js.map +1 -0
  13. package/dist/mcp/tools/coaiapy-tools.d.ts.map +1 -0
  14. package/dist/mcp/tools/coaiapy-tools.js.map +1 -0
  15. package/dist/mcp/tools/index.d.ts.map +1 -0
  16. package/dist/mcp/tools/index.js.map +1 -0
  17. package/dist/src/audio.d.ts.map +1 -0
  18. package/dist/src/audio.js.map +1 -0
  19. package/dist/src/cli-helpers.d.ts.map +1 -0
  20. package/dist/src/cli-helpers.js.map +1 -0
  21. package/dist/src/cli.d.ts.map +1 -0
  22. package/dist/src/cli.js +2 -1
  23. package/dist/src/cli.js.map +1 -0
  24. package/dist/src/config.d.ts.map +1 -0
  25. package/dist/src/config.js.map +1 -0
  26. package/dist/src/environment.d.ts.map +1 -0
  27. package/dist/src/environment.js.map +1 -0
  28. package/dist/src/github.d.ts.map +1 -0
  29. package/dist/src/github.js.map +1 -0
  30. package/dist/src/index.d.ts +1 -0
  31. package/dist/src/index.d.ts.map +1 -0
  32. package/dist/src/index.js +1 -0
  33. package/dist/src/index.js.map +1 -0
  34. package/dist/src/langfuse/client.d.ts.map +1 -0
  35. package/dist/src/langfuse/client.js.map +1 -0
  36. package/dist/src/langfuse/comments.d.ts.map +1 -0
  37. package/dist/src/langfuse/comments.js.map +1 -0
  38. package/dist/src/langfuse/datasets.d.ts.map +1 -0
  39. package/dist/src/langfuse/datasets.js.map +1 -0
  40. package/dist/src/langfuse/index.d.ts.map +1 -0
  41. package/dist/src/langfuse/index.js.map +1 -0
  42. package/dist/src/langfuse/media.d.ts.map +1 -0
  43. package/dist/src/langfuse/media.js.map +1 -0
  44. package/dist/src/langfuse/observations.d.ts.map +1 -0
  45. package/dist/src/langfuse/observations.js.map +1 -0
  46. package/dist/src/langfuse/prompts.d.ts.map +1 -0
  47. package/dist/src/langfuse/prompts.js.map +1 -0
  48. package/dist/src/langfuse/scores.d.ts.map +1 -0
  49. package/dist/src/langfuse/scores.js.map +1 -0
  50. package/dist/src/langfuse/traces.d.ts.map +1 -0
  51. package/dist/src/langfuse/traces.js.map +1 -0
  52. package/dist/src/llm.d.ts.map +1 -0
  53. package/dist/src/llm.js.map +1 -0
  54. package/dist/src/narrative/graph-manager.d.ts.map +1 -0
  55. package/dist/src/narrative/graph-manager.js.map +1 -0
  56. package/dist/src/narrative/index.d.ts.map +1 -0
  57. package/dist/src/narrative/index.js.map +1 -0
  58. package/dist/src/narrative/markdown-export.d.ts.map +1 -0
  59. package/dist/src/narrative/markdown-export.js.map +1 -0
  60. package/dist/src/narrative/tool-definitions.d.ts.map +1 -0
  61. package/dist/src/narrative/tool-definitions.js.map +1 -0
  62. package/dist/src/narrative/tool-handlers.d.ts.map +1 -0
  63. package/dist/src/narrative/tool-handlers.js.map +1 -0
  64. package/dist/src/narrative/types.d.ts.map +1 -0
  65. package/dist/src/narrative/types.js.map +1 -0
  66. package/dist/src/narrative/validation.d.ts.map +1 -0
  67. package/dist/src/narrative/validation.js.map +1 -0
  68. package/dist/src/pde/index.d.ts.map +1 -0
  69. package/dist/src/pde/index.js.map +1 -0
  70. package/dist/src/pde/mcp-handlers.d.ts.map +1 -0
  71. package/dist/src/pde/mcp-handlers.js.map +1 -0
  72. package/dist/src/pde/mcp-tools.d.ts.map +1 -0
  73. package/dist/src/pde/mcp-tools.js.map +1 -0
  74. package/dist/src/pde/session-manager.d.ts.map +1 -0
  75. package/dist/src/pde/session-manager.js.map +1 -0
  76. package/dist/src/pde/stc-mapper.d.ts.map +1 -0
  77. package/dist/src/pde/stc-mapper.js.map +1 -0
  78. package/dist/src/pipeline/index.d.ts.map +1 -0
  79. package/dist/src/pipeline/index.js.map +1 -0
  80. package/dist/src/pipeline/template-engine.d.ts.map +1 -0
  81. package/dist/src/pipeline/template-engine.js.map +1 -0
  82. package/dist/src/planning/index.d.ts.map +1 -0
  83. package/dist/src/planning/index.js.map +1 -0
  84. package/dist/src/planning/mcp-handlers.d.ts.map +1 -0
  85. package/dist/src/planning/mcp-handlers.js.map +1 -0
  86. package/dist/src/planning/mcp-tools.d.ts.map +1 -0
  87. package/dist/src/planning/mcp-tools.js.map +1 -0
  88. package/dist/src/planning/plan-parser.d.ts.map +1 -0
  89. package/dist/src/planning/plan-parser.js.map +1 -0
  90. package/dist/src/redis.d.ts.map +1 -0
  91. package/dist/src/redis.js.map +1 -0
  92. package/dist/src/types.d.ts.map +1 -0
  93. package/dist/src/types.js.map +1 -0
  94. package/dist/src/version.d.ts +3 -0
  95. package/dist/src/version.d.ts.map +1 -0
  96. package/dist/src/version.js +33 -0
  97. package/dist/src/version.js.map +1 -0
  98. package/llms-full.txt +361 -0
  99. package/llms.txt +43 -0
  100. package/package.json +79 -12
  101. package/.claude/settings.local.json +0 -16
  102. package/articles/academic/NOTES.md +0 -1
  103. package/articles/academic/README.md +0 -1
  104. package/articles/academic/creative-orientation-vs-problem-solving.md +0 -177
  105. package/articles/academic/jsonl-knowledge-graphs-agent-memory.md +0 -142
  106. package/articles/academic/langfuse-observability-llm-pipelines.md +0 -144
  107. package/articles/academic/medicine-wheel-software-architecture.md +0 -163
  108. package/articles/academic/mmot-autonomous-agents.md +0 -156
  109. package/articles/academic/model-context-protocol-interagent.md +0 -161
  110. package/articles/academic/pde-prompt-decomposition.md +0 -186
  111. package/articles/academic/structural-tension-in-ai-agents.md +0 -134
  112. package/articles/reviews/mcp-protocol-design-review.md +0 -170
  113. package/articles/reviews/observability-ai-systems-review.md +0 -176
  114. package/articles/reviews/prompt-engineering-decomposition-review.md +0 -184
  115. package/articles/surveys/agent-orchestration-survey.md +0 -186
  116. package/articles/surveys/knowledge-graph-storage-survey.md +0 -204
  117. package/articles/surveys/structural-tension-methodology-survey.md +0 -154
  118. package/articles/technical/aws-sdk-v3-polly.md +0 -270
  119. package/articles/technical/commander-cli-framework.md +0 -262
  120. package/articles/technical/dotenv-config-patterns.md +0 -360
  121. package/articles/technical/ioredis-vs-redis.md +0 -142
  122. package/articles/technical/langfuse-js-sdk-vs-rest.md +0 -191
  123. package/articles/technical/mcp-sdk-typescript.md +0 -291
  124. package/articles/technical/octokit-github-api.md +0 -293
  125. package/articles/technical/openai-sdk-modern.md +0 -231
  126. package/articles/technical/yaml-parsing-node.md +0 -266
  127. package/articles/technical/zod-runtime-validation.md +0 -212
  128. package/mcp/config.ts +0 -225
  129. package/mcp/prompts.ts +0 -131
  130. package/mcp/resources.ts +0 -84
  131. package/mcp/server.ts +0 -518
  132. package/mcp/tools/coaiapy-tools.ts +0 -366
  133. package/mcp/tools/index.ts +0 -4
  134. package/src/audio.ts +0 -76
  135. package/src/cli-helpers.ts +0 -86
  136. package/src/cli.ts +0 -1260
  137. package/src/config.ts +0 -207
  138. package/src/environment.ts +0 -171
  139. package/src/github.ts +0 -143
  140. package/src/index.ts +0 -82
  141. package/src/langfuse/client.ts +0 -105
  142. package/src/langfuse/comments.ts +0 -52
  143. package/src/langfuse/datasets.ts +0 -178
  144. package/src/langfuse/index.ts +0 -37
  145. package/src/langfuse/media.ts +0 -193
  146. package/src/langfuse/observations.ts +0 -155
  147. package/src/langfuse/prompts.ts +0 -157
  148. package/src/langfuse/scores.ts +0 -456
  149. package/src/langfuse/traces.ts +0 -353
  150. package/src/llm.ts +0 -106
  151. package/src/narrative/graph-manager.ts +0 -1358
  152. package/src/narrative/index.ts +0 -188
  153. package/src/narrative/markdown-export.ts +0 -535
  154. package/src/narrative/tool-definitions.ts +0 -635
  155. package/src/narrative/tool-handlers.ts +0 -528
  156. package/src/narrative/types.ts +0 -9
  157. package/src/narrative/validation.ts +0 -179
  158. package/src/pde/index.ts +0 -34
  159. package/src/pde/mcp-handlers.ts +0 -359
  160. package/src/pde/mcp-tools.ts +0 -201
  161. package/src/pde/session-manager.ts +0 -248
  162. package/src/pde/stc-mapper.ts +0 -298
  163. package/src/pipeline/index.ts +0 -7
  164. package/src/pipeline/template-engine.ts +0 -398
  165. package/src/planning/index.ts +0 -32
  166. package/src/planning/mcp-handlers.ts +0 -369
  167. package/src/planning/mcp-tools.ts +0 -155
  168. package/src/planning/plan-parser.ts +0 -587
  169. package/src/redis.ts +0 -111
  170. package/src/types.ts +0 -281
  171. package/test/config.test.mjs +0 -93
  172. package/tsconfig.json +0 -26
@@ -1,188 +0,0 @@
1
- // narrative/index.ts — Module barrel export
2
-
3
- export { KnowledgeGraphManager } from './graph-manager.js';
4
- export { handleToolCall } from './tool-handlers.js';
5
- export { validate, ValidationSchemas } from './validation.js';
6
- export {
7
- ALL_TOOL_DEFINITIONS,
8
- STC_TOOLS,
9
- NARRATIVE_TOOLS,
10
- KG_TOOLS,
11
- CORE_TOOLS,
12
- } from './tool-definitions.js';
13
- export type { ToolDefinition } from './tool-definitions.js';
14
- export {
15
- exportChartToMarkdown,
16
- exportAllCharts as exportAllChartsToMarkdown,
17
- exportChartProgress,
18
- exportChartStats,
19
- writeMarkdownToFile,
20
- getDefaultFilename,
21
- } from './markdown-export.js';
22
- export type { MarkdownOptions } from './markdown-export.js';
23
-
24
- // Re-export narrative-relevant types
25
- export type {
26
- Entity,
27
- EntityMetadata,
28
- Relation,
29
- RelationMetadata,
30
- KnowledgeGraph,
31
- McpToolResult,
32
- } from './types.js';
33
-
34
- import { writeFileSync } from 'node:fs';
35
- import { resolve } from 'node:path';
36
- import { KnowledgeGraphManager } from './graph-manager.js';
37
- import { handleToolCall } from './tool-handlers.js';
38
- import {
39
- exportChartToMarkdown as exportChartMarkdown,
40
- exportAllCharts as exportAllChartsMarkdown,
41
- exportChartProgress,
42
- exportChartStats,
43
- } from './markdown-export.js';
44
- import { createEnvironment } from '../environment.js';
45
- import type { McpToolResult } from '../types.js';
46
-
47
- interface CliGlobals {
48
- memoryPath?: string;
49
- }
50
-
51
- function managerFrom(opts?: CliGlobals): KnowledgeGraphManager {
52
- return new KnowledgeGraphManager(
53
- opts?.memoryPath ?? process.env['COAIAJS_MEMORY_PATH'] ?? 'coaia-memory.jsonl',
54
- );
55
- }
56
-
57
- function firstText(result: McpToolResult): string {
58
- return result.content[0]?.text ?? '';
59
- }
60
-
61
- export async function listCharts(opts?: CliGlobals): Promise<string> {
62
- return firstText(await handleToolCall('list_active_charts', {}, managerFrom(opts)));
63
- }
64
-
65
- export async function viewChart(chartId: string, opts?: CliGlobals): Promise<string> {
66
- return firstText(await handleToolCall('get_chart', { chartId }, managerFrom(opts)));
67
- }
68
-
69
- export async function setCurrentChart(chartId: string): Promise<void> {
70
- const env = createEnvironment();
71
- env.set('COAIA_CURRENT_CHART_ID', chartId);
72
- env.save();
73
- }
74
-
75
- export function getCurrentChart(): string | undefined {
76
- return createEnvironment().get('COAIA_CURRENT_CHART_ID');
77
- }
78
-
79
- export async function updateChart(
80
- chartId: string,
81
- opts: { desiredOutcome?: string; currentReality?: string },
82
- ): Promise<string[]> {
83
- const manager = managerFrom();
84
- const results: string[] = [];
85
- if (opts.desiredOutcome) {
86
- results.push(firstText(await handleToolCall(
87
- 'update_desired_outcome',
88
- { chartId, newDesiredOutcome: opts.desiredOutcome },
89
- manager,
90
- )));
91
- }
92
- if (opts.currentReality) {
93
- results.push(firstText(await handleToolCall(
94
- 'update_current_reality',
95
- { chartId, newObservations: [opts.currentReality] },
96
- manager,
97
- )));
98
- }
99
- if (results.length === 0) throw new Error('Provide --desired-outcome or --current-reality');
100
- return results;
101
- }
102
-
103
- export async function addAction(
104
- chartId: string,
105
- opts: { title?: string; currentReality?: string; due?: string },
106
- ): Promise<string> {
107
- if (!opts.title) throw new Error('--title is required');
108
- if (!opts.currentReality) throw new Error('--current-reality is required');
109
- return firstText(await handleToolCall(
110
- 'add_action_step',
111
- {
112
- parentChartId: chartId,
113
- actionStepTitle: opts.title,
114
- currentReality: opts.currentReality,
115
- dueDate: opts.due,
116
- },
117
- managerFrom(),
118
- ));
119
- }
120
-
121
- export async function addObservation(chartId: string, observation: string): Promise<string> {
122
- return firstText(await handleToolCall(
123
- 'update_current_reality',
124
- { chartId, newObservations: [observation] },
125
- managerFrom(),
126
- ));
127
- }
128
-
129
- export async function completeAction(actionName: string): Promise<string> {
130
- return firstText(await handleToolCall(
131
- 'mark_action_complete',
132
- { actionStepName: actionName },
133
- managerFrom(),
134
- ));
135
- }
136
-
137
- export async function exportChart(chartId: string): Promise<string> {
138
- return exportChartMarkdown(chartId, managerFrom());
139
- }
140
-
141
- export async function exportAllCharts(opts: { output?: string } = {}): Promise<string | { output: string }> {
142
- const markdown = await exportAllChartsMarkdown(managerFrom());
143
- if (opts.output) {
144
- const outPath = resolve(opts.output);
145
- writeFileSync(outPath, markdown, 'utf-8');
146
- return { output: outPath };
147
- }
148
- return markdown;
149
- }
150
-
151
- export async function getStats(): Promise<string> {
152
- return exportChartStats(managerFrom());
153
- }
154
-
155
- export async function getProgress(chartId: string): Promise<string> {
156
- return exportChartProgress(chartId, managerFrom());
157
- }
158
-
159
- export async function performMmot(
160
- chartId: string,
161
- opts: { assessment?: string; direction?: string },
162
- ): Promise<string> {
163
- return firstText(await handleToolCall(
164
- 'perform_mmot_evaluation',
165
- {
166
- chartId,
167
- assessment: opts.assessment,
168
- direction: opts.direction,
169
- },
170
- managerFrom(),
171
- ));
172
- }
173
-
174
- export async function setDueDate(chartId: string, date: string): Promise<string> {
175
- const graph = await managerFrom().readGraph();
176
- const chart = graph.entities.find(
177
- (entity) => entity.entityType === 'structural_tension_chart' && entity.metadata?.chartId === chartId,
178
- );
179
- if (!chart) throw new Error(`Chart not found: ${chartId}`);
180
- chart.metadata = { ...chart.metadata, dueDate: date, updatedAt: new Date().toISOString() };
181
- const entities = graph.entities.map((entity) => entity.name === chart.name ? chart : entity);
182
- const lines = [
183
- ...entities.map((entity) => JSON.stringify({ type: 'entity', ...entity })),
184
- ...graph.relations.map((relation) => JSON.stringify({ type: 'relation', ...relation })),
185
- ];
186
- writeFileSync(process.env['COAIAJS_MEMORY_PATH'] ?? 'coaia-memory.jsonl', lines.join('\n'), 'utf-8');
187
- return `Due date set for ${chartId}`;
188
- }