coaiajs 0.3.0 → 0.3.2

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 (179) 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 +1 -1
  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 +1 -0
  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 +1 -0
  41. package/dist/src/langfuse/index.d.ts.map +1 -0
  42. package/dist/src/langfuse/index.js.map +1 -0
  43. package/dist/src/langfuse/media.d.ts.map +1 -0
  44. package/dist/src/langfuse/media.js.map +1 -0
  45. package/dist/src/langfuse/observations.d.ts.map +1 -0
  46. package/dist/src/langfuse/observations.js.map +1 -0
  47. package/dist/src/langfuse/prompts.d.ts +5 -1
  48. package/dist/src/langfuse/prompts.d.ts.map +1 -0
  49. package/dist/src/langfuse/prompts.js +16 -3
  50. package/dist/src/langfuse/prompts.js.map +1 -0
  51. package/dist/src/langfuse/scores.d.ts.map +1 -0
  52. package/dist/src/langfuse/scores.js.map +1 -0
  53. package/dist/src/langfuse/traces.d.ts.map +1 -0
  54. package/dist/src/langfuse/traces.js.map +1 -0
  55. package/dist/src/llm.d.ts.map +1 -0
  56. package/dist/src/llm.js.map +1 -0
  57. package/dist/src/narrative/graph-manager.d.ts.map +1 -0
  58. package/dist/src/narrative/graph-manager.js.map +1 -0
  59. package/dist/src/narrative/index.d.ts.map +1 -0
  60. package/dist/src/narrative/index.js.map +1 -0
  61. package/dist/src/narrative/markdown-export.d.ts.map +1 -0
  62. package/dist/src/narrative/markdown-export.js.map +1 -0
  63. package/dist/src/narrative/tool-definitions.d.ts.map +1 -0
  64. package/dist/src/narrative/tool-definitions.js.map +1 -0
  65. package/dist/src/narrative/tool-handlers.d.ts.map +1 -0
  66. package/dist/src/narrative/tool-handlers.js.map +1 -0
  67. package/dist/src/narrative/types.d.ts.map +1 -0
  68. package/dist/src/narrative/types.js.map +1 -0
  69. package/dist/src/narrative/validation.d.ts.map +1 -0
  70. package/dist/src/narrative/validation.js.map +1 -0
  71. package/dist/src/pde/index.d.ts.map +1 -0
  72. package/dist/src/pde/index.js.map +1 -0
  73. package/dist/src/pde/mcp-handlers.d.ts.map +1 -0
  74. package/dist/src/pde/mcp-handlers.js.map +1 -0
  75. package/dist/src/pde/mcp-tools.d.ts.map +1 -0
  76. package/dist/src/pde/mcp-tools.js.map +1 -0
  77. package/dist/src/pde/session-manager.d.ts.map +1 -0
  78. package/dist/src/pde/session-manager.js.map +1 -0
  79. package/dist/src/pde/stc-mapper.d.ts.map +1 -0
  80. package/dist/src/pde/stc-mapper.js.map +1 -0
  81. package/dist/src/pipeline/index.d.ts.map +1 -0
  82. package/dist/src/pipeline/index.js.map +1 -0
  83. package/dist/src/pipeline/template-engine.d.ts.map +1 -0
  84. package/dist/src/pipeline/template-engine.js.map +1 -0
  85. package/dist/src/planning/index.d.ts.map +1 -0
  86. package/dist/src/planning/index.js.map +1 -0
  87. package/dist/src/planning/mcp-handlers.d.ts.map +1 -0
  88. package/dist/src/planning/mcp-handlers.js.map +1 -0
  89. package/dist/src/planning/mcp-tools.d.ts.map +1 -0
  90. package/dist/src/planning/mcp-tools.js.map +1 -0
  91. package/dist/src/planning/plan-parser.d.ts.map +1 -0
  92. package/dist/src/planning/plan-parser.js.map +1 -0
  93. package/dist/src/redis.d.ts.map +1 -0
  94. package/dist/src/redis.js.map +1 -0
  95. package/dist/src/types.d.ts.map +1 -0
  96. package/dist/src/types.js.map +1 -0
  97. package/dist/src/version.d.ts.map +1 -0
  98. package/dist/src/version.js.map +1 -0
  99. package/llms-full.txt +361 -0
  100. package/llms.txt +43 -0
  101. package/package.json +79 -12
  102. package/.claude/settings.local.json +0 -17
  103. package/.claude-plugin/marketplace.json +0 -26
  104. package/articles/academic/NOTES.md +0 -1
  105. package/articles/academic/README.md +0 -1
  106. package/articles/academic/creative-orientation-vs-problem-solving.md +0 -177
  107. package/articles/academic/jsonl-knowledge-graphs-agent-memory.md +0 -142
  108. package/articles/academic/langfuse-observability-llm-pipelines.md +0 -144
  109. package/articles/academic/medicine-wheel-software-architecture.md +0 -163
  110. package/articles/academic/mmot-autonomous-agents.md +0 -156
  111. package/articles/academic/model-context-protocol-interagent.md +0 -161
  112. package/articles/academic/pde-prompt-decomposition.md +0 -186
  113. package/articles/academic/structural-tension-in-ai-agents.md +0 -134
  114. package/articles/reviews/mcp-protocol-design-review.md +0 -170
  115. package/articles/reviews/observability-ai-systems-review.md +0 -176
  116. package/articles/reviews/prompt-engineering-decomposition-review.md +0 -184
  117. package/articles/surveys/agent-orchestration-survey.md +0 -186
  118. package/articles/surveys/knowledge-graph-storage-survey.md +0 -204
  119. package/articles/surveys/structural-tension-methodology-survey.md +0 -154
  120. package/articles/technical/aws-sdk-v3-polly.md +0 -270
  121. package/articles/technical/commander-cli-framework.md +0 -262
  122. package/articles/technical/dotenv-config-patterns.md +0 -360
  123. package/articles/technical/ioredis-vs-redis.md +0 -142
  124. package/articles/technical/langfuse-js-sdk-vs-rest.md +0 -191
  125. package/articles/technical/mcp-sdk-typescript.md +0 -291
  126. package/articles/technical/octokit-github-api.md +0 -293
  127. package/articles/technical/openai-sdk-modern.md +0 -231
  128. package/articles/technical/yaml-parsing-node.md +0 -266
  129. package/articles/technical/zod-runtime-validation.md +0 -212
  130. package/coaiajs-langfuse-claude-plugin/.claude-plugin/marketplace.json +0 -16
  131. package/coaiajs-langfuse-claude-plugin/.claude-plugin/plugin.json +0 -10
  132. package/coaiajs-langfuse-claude-plugin/.mcp.json +0 -8
  133. package/coaiajs-langfuse-claude-plugin/README.md +0 -60
  134. package/mcp/config.ts +0 -225
  135. package/mcp/prompts.ts +0 -131
  136. package/mcp/resources.ts +0 -84
  137. package/mcp/server.ts +0 -519
  138. package/mcp/tools/coaiapy-tools.ts +0 -366
  139. package/mcp/tools/index.ts +0 -4
  140. package/src/audio.ts +0 -76
  141. package/src/cli-helpers.ts +0 -86
  142. package/src/cli.ts +0 -1261
  143. package/src/config.ts +0 -207
  144. package/src/environment.ts +0 -171
  145. package/src/github.ts +0 -143
  146. package/src/index.ts +0 -82
  147. package/src/langfuse/client.ts +0 -105
  148. package/src/langfuse/comments.ts +0 -52
  149. package/src/langfuse/datasets.ts +0 -178
  150. package/src/langfuse/index.ts +0 -37
  151. package/src/langfuse/media.ts +0 -193
  152. package/src/langfuse/observations.ts +0 -155
  153. package/src/langfuse/prompts.ts +0 -157
  154. package/src/langfuse/scores.ts +0 -456
  155. package/src/langfuse/traces.ts +0 -353
  156. package/src/llm.ts +0 -106
  157. package/src/narrative/graph-manager.ts +0 -1358
  158. package/src/narrative/index.ts +0 -188
  159. package/src/narrative/markdown-export.ts +0 -535
  160. package/src/narrative/tool-definitions.ts +0 -635
  161. package/src/narrative/tool-handlers.ts +0 -528
  162. package/src/narrative/types.ts +0 -9
  163. package/src/narrative/validation.ts +0 -179
  164. package/src/pde/index.ts +0 -34
  165. package/src/pde/mcp-handlers.ts +0 -359
  166. package/src/pde/mcp-tools.ts +0 -201
  167. package/src/pde/session-manager.ts +0 -248
  168. package/src/pde/stc-mapper.ts +0 -298
  169. package/src/pipeline/index.ts +0 -7
  170. package/src/pipeline/template-engine.ts +0 -398
  171. package/src/planning/index.ts +0 -32
  172. package/src/planning/mcp-handlers.ts +0 -369
  173. package/src/planning/mcp-tools.ts +0 -155
  174. package/src/planning/plan-parser.ts +0 -587
  175. package/src/redis.ts +0 -111
  176. package/src/types.ts +0 -281
  177. package/src/version.ts +0 -39
  178. package/test/config.test.mjs +0 -93
  179. 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
- }