coaiajs 0.1.0

package/dist/src/types.d.ts

@@ -0,0 +1,244 @@
+export interface Entity {
+    name: string;
+    entityType: string;
+    observations: string[];
+    metadata?: EntityMetadata;
+}
+export interface EntityMetadata {
+    dueDate?: string;
+    chartId?: string;
+    phase?: 'germination' | 'assimilation' | 'completion';
+    completionStatus?: boolean;
+    parentChart?: string;
+    parentActionStep?: string;
+    level?: number;
+    createdAt?: string;
+    updatedAt?: string;
+    direction?: string;
+    confidence?: number;
+    implicit?: boolean;
+    pdeId?: string;
+    act?: number;
+    type_dramatic?: string;
+    universes?: string[];
+    timestamp?: string;
+    elementsOfPerformance?: Array<{
+        description: string;
+        type: 'DESIGN' | 'EXECUTION';
+    }>;
+    mmotEvaluations?: Array<{
+        phase: 'acknowledge' | 'analyze' | 'update' | 'recommit';
+        assessment: string;
+        direction?: 'South' | 'East' | 'West' | 'North';
+        timestamp: string;
+    }>;
+    relationalAlignment?: {
+        assessed: boolean;
+        score: number | null;
+        principles: string[];
+    };
+    fourDirections?: {
+        north_vision: string | null;
+        east_intention: string | null;
+        south_emotion: string | null;
+        west_introspection: string | null;
+    };
+    narrative?: {
+        description: string;
+        prose: string;
+        lessons: string[];
+    };
+    order?: number;
+}
+export interface Relation {
+    from: string;
+    to: string;
+    relationType: string;
+    metadata?: RelationMetadata;
+}
+export interface RelationMetadata {
+    createdAt?: string;
+    strength?: number;
+    context?: string;
+    description?: string;
+}
+export interface KnowledgeGraph {
+    entities: Entity[];
+    relations: Relation[];
+}
+export interface McpToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+export type Urgency = 'immediate' | 'session' | 'persistent';
+export type Direction = 'east' | 'south' | 'west' | 'north';
+export interface PrimaryIntent {
+    action: string;
+    target: string;
+    urgency: Urgency;
+    confidence: number;
+}
+export interface SecondaryIntent {
+    action: string;
+    target: string;
+    implicit: boolean;
+    dependency: string | null;
+    confidence: number;
+}
+export interface ContextRequirements {
+    files_needed: string[];
+    tools_required: string[];
+    assumptions: string[];
+}
+export interface ExpectedOutputs {
+    artifacts: string[];
+    updates: string[];
+    communications: string[];
+}
+export interface DirectionItem {
+    text: string;
+    confidence: number;
+    implicit: boolean;
+}
+export type DirectionMap = Record<Direction, DirectionItem[]>;
+export interface ActionItem {
+    text: string;
+    direction: Direction;
+    dependency: string | null;
+    completed?: boolean;
+}
+export interface AmbiguityFlag {
+    text: string;
+    suggestion: string;
+}
+export interface DecompositionResult {
+    primary: PrimaryIntent;
+    secondary: SecondaryIntent[];
+    context: ContextRequirements;
+    outputs: ExpectedOutputs;
+    directions: DirectionMap;
+    actionStack: ActionItem[];
+    ambiguities: AmbiguityFlag[];
+}
+export interface StoredDecomposition {
+    id: string;
+    timestamp: string;
+    prompt: string;
+    result: DecompositionResult;
+    options: DecompositionOptions;
+    markdownPath?: string;
+}
+export interface DecompositionOptions {
+    extractImplicit: boolean;
+    mapDependencies: boolean;
+}
+export interface PdeSession {
+    type: 'pde_session';
+    sessionId: string;
+    originalPrompt: string;
+    masterChartId: string;
+    pdeDecompositionId?: string;
+    createdAt: string;
+    updatedAt: string;
+    status: 'active' | 'completed' | 'abandoned';
+    metadata?: Record<string, unknown>;
+}
+export declare const URGENCY_DAYS: Record<string, number>;
+export interface StructuralElement {
+    type: 'desired_outcome' | 'current_reality' | 'action_step' | 'observation';
+    content: string;
+    confidence: number;
+    sourceLines: {
+        start: number;
+        end: number;
+    };
+    telescopesInto?: StructuralTensionPlan;
+}
+export interface StructuralTensionPlan {
+    title: string;
+    filePath: string;
+    desiredOutcome: StructuralElement | null;
+    currentReality: StructuralElement | null;
+    actionSteps: StructuralElement[];
+    observations: string[];
+    metadata: {
+        parsedAt: string;
+        telescopeLevel: number;
+        parentAction?: string;
+        dueDate?: string;
+        completionStatus: 'pending' | 'in_progress' | 'completed';
+    };
+}
+export interface ScoreCategory {
+    label: string;
+    value: number;
+}
+export interface ScoreConfig {
+    name: string;
+    dataType: 'NUMERIC' | 'CATEGORICAL' | 'BOOLEAN';
+    description?: string;
+    categories?: ScoreCategory[];
+    minValue?: number;
+    maxValue?: number;
+    isArchived?: boolean;
+}
+export interface PipelineVariable {
+    name: string;
+    type: string;
+    required: boolean;
+    default?: string;
+    description?: string;
+    choices?: string[];
+}
+export interface PipelineStep {
+    name: string;
+    observationType: string;
+    description?: string;
+    parent?: string;
+    variables?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+    conditional?: string;
+}
+export interface PipelineTemplate {
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+    createdAt?: string;
+    variables: PipelineVariable[];
+    steps: PipelineStep[];
+    extends?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CoaiaConfig {
+    redis?: {
+        url?: string;
+        host?: string;
+        port?: number;
+        password?: string;
+        upstashUrl?: string;
+        upstashToken?: string;
+    };
+    langfuse?: {
+        publicKey?: string;
+        secretKey?: string;
+        baseUrl?: string;
+    };
+    openai?: {
+        apiKey?: string;
+        model?: string;
+    };
+    aws?: {
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        region?: string;
+    };
+    github?: {
+        token?: string;
+    };
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.js

@@ -0,0 +1,8 @@
+// coaiajs/src/types.ts — Shared types
+// Union of coaia-narrative + coaia-pde + coaia-planning type systems
+export const URGENCY_DAYS = {
+    immediate: 1,
+    session: 7,
+    persistent: 30,
+};
+//# sourceMappingURL=types.js.map

package/mcp/config.ts

@@ -0,0 +1,196 @@
+// coaiajs/mcp/config.ts — Feature gating
+// Port of coaiapy-mcp/config.py
+
+export type FeatureLevel = 'MINIMAL' | 'STANDARD' | 'OBSERVABILITY' | 'FULL';
+
+// All available tool names across all modules
+const ALL_TOOLS = new Set([
+  // Redis (coaiapy-mcp)
+  'coaia_tash',
+  'coaia_fetch',
+  // Langfuse traces (coaiapy-mcp)
+  'coaia_fuse_trace_create',
+  'coaia_fuse_add_observation',
+  'coaia_fuse_trace_patch_output',
+  'coaia_fuse_trace_get',
+  'coaia_fuse_trace_view',
+  'coaia_fuse_observation_get',
+  'coaia_fuse_traces_list',
+  'coaia_fuse_traces_session_view',
+  // Langfuse comments (coaiapy-mcp)
+  'coaia_fuse_comments_list',
+  'coaia_fuse_comments_get',
+  'coaia_fuse_comments_create',
+  // Langfuse prompts (coaiapy-mcp)
+  'coaia_fuse_prompts_list',
+  'coaia_fuse_prompts_get',
+  // Langfuse datasets (coaiapy-mcp)
+  'coaia_fuse_datasets_list',
+  'coaia_fuse_datasets_get',
+  // Score configs (coaiapy-mcp)
+  'coaia_fuse_score_configs_list',
+  'coaia_fuse_score_configs_get',
+  'coaia_fuse_score_apply',
+  // Media (coaiapy-mcp, FULL only)
+  'coaia_fuse_media_upload',
+  'coaia_fuse_media_get',
+  // Narrative (coaia-narrative, 28 tools)
+  'create_structural_tension_chart',
+  'telescope_action_step',
+  'mark_action_complete',
+  'get_chart_progress',
+  'list_active_charts',
+  'get_chart',
+  'get_action_step',
+  'update_action_progress',
+  'update_current_reality',
+  'manage_action_step',
+  'add_action_step',
+  'remove_action_step',
+  'update_desired_outcome',
+  'perform_mmot_evaluation',
+  'init_llm_guidance',
+  'create_narrative_beat',
+  'telescope_narrative_beat',
+  'list_narrative_beats',
+  'add_observations',
+  'create_entities',
+  'create_relations',
+  'search_nodes',
+  'open_nodes',
+  'read_graph',
+  'delete_entities',
+  'delete_relations',
+  'delete_observations',
+  'merge_entities',
+  // PDE (coaia-pde, 10 tools)
+  'pde_decompose',
+  'pde_parse_response',
+  'pde_get',
+  'pde_list',
+  'pde_export_markdown',
+  'import_pde',
+  'create_stc_from_pde',
+  'pde_sessions_list',
+  'pde_sessions_create',
+  'pde_sessions_update',
+  // Planning (coaia-planning, 6 tools)
+  'parse_plan',
+  'plan_to_stc',
+  'sync_plans',
+  'trace_plan',
+  'pde_to_plan',
+  'list_plans',
+]);
+
+const MINIMAL_TOOLS = new Set([
+  'coaia_tash',
+  'coaia_fetch',
+  'coaia_fuse_trace_create',
+  'coaia_fuse_add_observation',
+  'coaia_fuse_trace_patch_output',
+  'coaia_fuse_trace_get',
+  'coaia_fuse_trace_view',
+  'coaia_fuse_observation_get',
+  'coaia_fuse_traces_list',
+  'coaia_fuse_traces_session_view',
+  'coaia_fuse_comments_list',
+  'coaia_fuse_comments_get',
+  'coaia_fuse_comments_create',
+  'coaia_fuse_prompts_list',
+  'coaia_fuse_prompts_get',
+  'coaia_fuse_datasets_list',
+  'coaia_fuse_datasets_get',
+  'coaia_fuse_score_configs_list',
+  'coaia_fuse_score_configs_get',
+  'coaia_fuse_score_apply',
+]);
+
+const STANDARD_TOOLS = new Set([
+  ...MINIMAL_TOOLS,
+  // Narrative STC tools
+  'create_structural_tension_chart',
+  'telescope_action_step',
+  'mark_action_complete',
+  'get_chart_progress',
+  'list_active_charts',
+  'get_chart',
+  'get_action_step',
+  'update_action_progress',
+  'update_current_reality',
+  'manage_action_step',
+  'add_action_step',
+  'remove_action_step',
+  'update_desired_outcome',
+  'perform_mmot_evaluation',
+  'init_llm_guidance',
+  'create_narrative_beat',
+  'telescope_narrative_beat',
+  'list_narrative_beats',
+  // KG tools
+  'add_observations',
+  'create_entities',
+  'create_relations',
+  'search_nodes',
+  'open_nodes',
+  'read_graph',
+  'delete_entities',
+  'delete_relations',
+  'delete_observations',
+  'merge_entities',
+  // PDE tools
+  'pde_decompose',
+  'pde_parse_response',
+  'pde_get',
+  'pde_list',
+  'pde_export_markdown',
+  'import_pde',
+  'create_stc_from_pde',
+  'pde_sessions_list',
+  'pde_sessions_create',
+  'pde_sessions_update',
+  // Planning tools
+  'parse_plan',
+  'plan_to_stc',
+  'sync_plans',
+  'trace_plan',
+  'pde_to_plan',
+  'list_plans',
+]);
+
+const FEATURE_SETS: Record<FeatureLevel, Set<string>> = {
+  MINIMAL: MINIMAL_TOOLS,
+  STANDARD: STANDARD_TOOLS,
+  OBSERVABILITY: STANDARD_TOOLS,
+  FULL: ALL_TOOLS,
+};
+
+export class FeatureConfig {
+  private level: FeatureLevel;
+  private enabledTools: Set<string>;
+
+  constructor(level?: FeatureLevel) {
+    const envLevel = (level ?? process.env['COAIAJS_FEATURES'] ?? 'STANDARD').toUpperCase() as FeatureLevel;
+    this.level = envLevel in FEATURE_SETS ? envLevel : 'STANDARD';
+    this.enabledTools = FEATURE_SETS[this.level];
+  }
+
+  isToolEnabled(toolName: string): boolean {
+    return this.enabledTools.has(toolName);
+  }
+
+  getEnabledTools(): Set<string> {
+    return new Set(this.enabledTools);
+  }
+
+  getFeatureLevel(): FeatureLevel {
+    return this.level;
+  }
+
+  getStats(): { tools: number; level: FeatureLevel } {
+    return {
+      tools: this.enabledTools.size,
+      level: this.level,
+    };
+  }
+}