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