contextsynapse 1.0.0__py3-none-any.whl

contextsynapse/config/schemas/screener_meta.yaml

@@ -0,0 +1,236 @@
+# screener_meta.yaml — Stock screener field definitions and configuration
+# All fields, groups, operators, and periods are defined here.
+# The frontend reads this from API — nothing is hardcoded in JS.
+
+field_groups:
+  - id: leverage
+    label: "Leverage"
+    fields:
+      - id: total_debt
+        label: "Total Debt"
+        unit: "Rs.Cr."
+        description: "Total borrowings as per latest annual numbers"
+        type: number
+      - id: debt_to_equity
+        label: "Debt / Equity"
+        unit: "x"
+        description: "Total debt divided by net worth"
+        type: number
+      - id: interest_coverage
+        label: "Interest Coverage"
+        unit: "x"
+        description: "EBIT divided by interest expense"
+        type: number
+
+  - id: profitability
+    label: "Profitability"
+    fields:
+      - id: pat
+        label: "Net Profit (PAT)"
+        unit: "Rs.Cr."
+        description: "Profit after tax"
+        type: number
+      - id: ebitda
+        label: "EBITDA"
+        unit: "Rs.Cr."
+        description: "Earnings before interest, taxes, depreciation & amortisation"
+        type: number
+      - id: roe
+        label: "Return on Equity"
+        unit: "%"
+        description: "Net profit as % of shareholder equity"
+        type: number
+      - id: roce
+        label: "Return on Capital Employed"
+        unit: "%"
+        description: "EBIT as % of capital employed"
+        type: number
+      - id: net_margin
+        label: "Net Profit Margin"
+        unit: "%"
+        description: "PAT as % of revenue"
+        type: number
+      - id: ebitda_margin
+        label: "EBITDA Margin"
+        unit: "%"
+        description: "EBITDA as % of revenue"
+        type: number
+
+  - id: scale
+    label: "Scale"
+    fields:
+      - id: revenue
+        label: "Revenue / Sales"
+        unit: "Rs.Cr."
+        description: "Total revenue from operations"
+        type: number
+      - id: market_cap
+        label: "Market Capitalisation"
+        unit: "Rs.Cr."
+        description: "Current market capitalisation"
+        type: number
+      - id: total_assets
+        label: "Total Assets"
+        unit: "Rs.Cr."
+        description: "Total assets on balance sheet"
+        type: number
+      - id: net_worth
+        label: "Net Worth"
+        unit: "Rs.Cr."
+        description: "Shareholder equity / book value"
+        type: number
+
+  - id: valuation
+    label: "Valuation"
+    fields:
+      - id: pe_ratio
+        label: "PE Ratio"
+        unit: "x"
+        description: "Price to earnings ratio (trailing)"
+        type: number
+      - id: pb_ratio
+        label: "PB Ratio"
+        unit: "x"
+        description: "Price to book value ratio"
+        type: number
+      - id: ev_ebitda
+        label: "EV / EBITDA"
+        unit: "x"
+        description: "Enterprise value to EBITDA"
+        type: number
+
+  - id: growth
+    label: "Growth"
+    fields:
+      - id: revenue_growth
+        label: "Revenue Growth (YoY)"
+        unit: "%"
+        description: "Year-on-year revenue growth"
+        type: number
+      - id: pat_growth
+        label: "PAT Growth (YoY)"
+        unit: "%"
+        description: "Year-on-year profit growth"
+        type: number
+      - id: eps_growth
+        label: "EPS Growth (YoY)"
+        unit: "%"
+        description: "Year-on-year earnings per share growth"
+        type: number
+
+  - id: liquidity
+    label: "Liquidity"
+    fields:
+      - id: current_ratio
+        label: "Current Ratio"
+        unit: "x"
+        description: "Current assets divided by current liabilities"
+        type: number
+      - id: cash_equivalents
+        label: "Cash & Equivalents"
+        unit: "Rs.Cr."
+        description: "Cash and short-term investments"
+        type: number
+
+  - id: market
+    label: "Market Data"
+    fields:
+      - id: current_price
+        label: "Current Price"
+        unit: "Rs."
+        description: "Last traded price"
+        type: number
+      - id: high_52w
+        label: "52-Week High"
+        unit: "Rs."
+        description: "Highest price in last 52 weeks"
+        type: number
+      - id: low_52w
+        label: "52-Week Low"
+        unit: "Rs."
+        description: "Lowest price in last 52 weeks"
+        type: number
+      - id: dividend_yield
+        label: "Dividend Yield"
+        unit: "%"
+        description: "Annual dividend as % of current price"
+        type: number
+
+operators:
+  - id: gt
+    label: ">"
+    description: "Greater than"
+  - id: gte
+    label: ">="
+    description: "Greater than or equal to"
+  - id: lt
+    label: "<"
+    description: "Less than"
+  - id: lte
+    label: "<="
+    description: "Less than or equal to"
+  - id: eq
+    label: "="
+    description: "Equals"
+
+result_periods:
+  - id: "Jun 2026"
+    label: "Jun 2026"
+    period_type: quarterly
+    description: "Q1 FY27 results"
+  - id: "Mar 2026"
+    label: "Mar 2026"
+    period_type: annual
+    description: "FY26 annual results"
+  - id: "Dec 2025"
+    label: "Dec 2025"
+    period_type: quarterly
+    description: "Q3 FY26 results"
+  - id: "Sep 2025"
+    label: "Sep 2025"
+    period_type: quarterly
+    description: "Q2 FY26 results"
+  - id: "Mar 2025"
+    label: "Mar 2025"
+    period_type: annual
+    description: "FY25 annual results"
+
+result_columns:
+  - id: name
+    label: "Company"
+    width: 200
+  - id: sector
+    label: "Sector"
+    width: 120
+  - id: market_cap
+    label: "Mkt Cap (Cr.)"
+    width: 120
+    align: right
+  - id: current_price
+    label: "CMP (Rs.)"
+    width: 100
+    align: right
+  - id: pe_ratio
+    label: "PE"
+    width: 80
+    align: right
+  - id: roe
+    label: "ROE %"
+    width: 80
+    align: right
+  - id: revenue
+    label: "Revenue (Cr.)"
+    width: 120
+    align: right
+  - id: pat
+    label: "PAT (Cr.)"
+    width: 100
+    align: right
+  - id: total_debt
+    label: "Debt (Cr.)"
+    width: 100
+    align: right
+  - id: debt_to_equity
+    label: "D/E"
+    width: 70
+    align: right

contextsynapse/config/schemas/sdlc.yaml

@@ -0,0 +1,103 @@
+# SDLC Extraction Schema
+# Used when ingesting requirements docs, project plans, and architecture specs
+# into a software_dev context. The LLM extracts these specific entity types
+# instead of generic TextChunks.
+
+name: sdlc
+
+node_types:
+  Feature:
+    fields: [name, description, priority, status, acceptance_criteria]
+    required: [name]
+    description: "A product feature or capability to be built"
+
+  UserStory:
+    fields: [title, as_a, i_want, so_that, acceptance_criteria, priority, story_points]
+    required: [title]
+    description: "A user story in as-a/i-want/so-that format"
+
+  Requirement:
+    fields: [title, description, type, priority, status]
+    required: [title]
+    description: "A functional or non-functional requirement (type: functional, non_functional, performance, security)"
+
+  Constraint:
+    fields: [title, description, type, severity]
+    required: [title]
+    description: "A technical or business constraint (type: technical, business, regulatory, timeline)"
+
+  Milestone:
+    fields: [name, description, target_date, status, deliverables]
+    required: [name]
+    description: "A project milestone or phase with a target date"
+
+  Component:
+    fields: [name, description, type, technology, owner]
+    required: [name]
+    description: "A system component or module (type: frontend, backend, database, service, library)"
+
+  APIEndpoint:
+    fields: [method, path, description, request_body, response_body, auth_required]
+    required: [path]
+    description: "A REST API endpoint specification"
+
+  DataModel:
+    fields: [name, description, fields, primary_key, indexes]
+    required: [name]
+    description: "A data model or database table definition"
+
+  Risk:
+    fields: [title, description, probability, impact, mitigation]
+    required: [title]
+    description: "A project risk with mitigation strategy"
+
+  Stakeholder:
+    fields: [name, role, responsibilities, contact]
+    required: [name]
+    description: "A project stakeholder or team member"
+
+edge_types:
+  IMPLEMENTS:
+    source: Component
+    target: Feature
+  DEPENDS_ON:
+    source: Feature
+    target: Feature
+  BELONGS_TO:
+    source: UserStory
+    target: Feature
+  CONSTRAINED_BY:
+    source: Feature
+    target: Constraint
+  DELIVERS:
+    source: Milestone
+    target: Feature
+  USES:
+    source: Component
+    target: Component
+  EXPOSES:
+    source: Component
+    target: APIEndpoint
+  STORES:
+    source: Component
+    target: DataModel
+  OWNS:
+    source: Stakeholder
+    target: Component
+  MITIGATES:
+    source: Risk
+    target: Feature
+  REQUIRES:
+    source: Feature
+    target: Requirement
+
+fact_types:
+  - type: TechDecision
+    fields: [statement, rationale, alternatives, decided_by]
+    description: "A technology or architecture decision"
+  - type: Assumption
+    fields: [statement, confidence, impact_if_wrong]
+    description: "A project assumption that needs validation"
+  - type: Metric
+    fields: [name, target_value, unit, measurement_method]
+    description: "A performance or business metric with target"

contextsynapse/config/schemas/session_graph.yaml

@@ -0,0 +1,172 @@
+NAMESPACE: session_graph
+VERSION: "1.0"
+DESCRIPTION: >
+  Unified session graph schema. The knowledge layer (Document, TextChunk,
+  Entity) is built by the ingestion pipeline. The conversation layer (Turn,
+  Topic, Decision, Question, Action) is built by the InteractionGraphifier
+  as agents interact. Cross-layer edges (REFERENCES, AFFECTS, ABOUT) link
+  conversation nodes to knowledge nodes so agents can traverse from
+  "what did we discuss about X" to the actual entity node for X.
+
+  This file is editable. Add or remove node/edge types to control what the
+  session graph accepts. The SchemaValidator enforces these constraints.
+
+# ──────────────────────────────────────────────────────────────────────────
+# Knowledge Layer — created by ingestion pipelines
+# ──────────────────────────────────────────────────────────────────────────
+
+NODES:
+  Document:
+    description: An ingested document (PDF, text, URL, etc.)
+    fields:
+      title: string
+      source: string
+      text: string
+      created_at: datetime
+
+  TextChunk:
+    description: A chunk of text split from a document
+    fields:
+      content: string!
+      chunk_index: int
+      parent_id: string
+
+  Entity:
+    description: A named entity extracted from text
+    fields:
+      entity_name: string!
+      entity_type: string!
+      description: string
+
+  Relationship:
+    description: An extracted relationship between entities
+    fields:
+      relation_type: string!
+      description: string
+
+  # ────────────────────────────────────────────────────────────────────────
+  # Conversation Layer — created by InteractionGraphifier
+  # ────────────────────────────────────────────────────────────────────────
+
+  AgentPresence:
+    description: An agent's presence in this session
+    fields:
+      agent_id: string!
+      agent_name: string
+      joined_at: datetime!
+      platform: string
+
+  Turn:
+    description: A single message turn (user, assistant, system, or tool)
+    fields:
+      role: string!
+      content: string!
+      agent_id: string!
+      timestamp: datetime!
+      turn_index: int!
+      conversation_id: string
+      significance: float
+
+  Topic:
+    description: A topic or subject extracted from conversation
+    fields:
+      name: string!
+      first_mentioned_at: datetime
+      mention_count: int
+
+  Decision:
+    description: A decision made during conversation
+    fields:
+      summary: string!
+      decided_at: datetime!
+      agent_id: string
+      confidence: float
+
+  Question:
+    description: A question raised during conversation
+    fields:
+      text: string!
+      asked_at: datetime!
+      agent_id: string
+      status: string
+
+  Action:
+    description: An action item or commitment from conversation
+    fields:
+      description: string!
+      assigned_to: string
+      created_at: datetime!
+      status: string
+
+# ──────────────────────────────────────────────────────────────────────────
+# Edges
+# ──────────────────────────────────────────────────────────────────────────
+
+EDGES:
+  # Conversation layer
+  NEXT_TURN:
+    from: Turn
+    to: Turn
+    relation: next_turn_in_agent_chain
+
+  SPOKEN_BY:
+    from: Turn
+    to: AgentPresence
+    relation: spoken_by_agent
+
+  RAISES:
+    from: Turn
+    to: [Topic, Question]
+    relation: raises_subject
+
+  DECIDES:
+    from: Turn
+    to: Decision
+    relation: decides_on
+
+  ASSIGNS:
+    from: Turn
+    to: Action
+    relation: assigns_action
+
+  CONCURRENT_WITH:
+    from: Turn
+    to: Turn
+    relation: concurrent_cross_agent
+
+  ANSWERS:
+    from: Turn
+    to: Question
+    relation: answers_question
+
+  # Cross-layer
+  REFERENCES:
+    from: [Turn, Decision, Action]
+    to: [Entity, Document, TextChunk]
+    relation: references_knowledge
+
+  AFFECTS:
+    from: Decision
+    to: [Entity, Document]
+    relation: affects_entity
+
+  ABOUT:
+    from: [Question, Topic]
+    to: [Entity, Document]
+    relation: about_entity
+
+  # Knowledge layer (from ingestion)
+  CONTAINS_CHUNK:
+    from: Document
+    to: TextChunk
+    relation: contains_chunk
+
+  MENTIONS:
+    from: [TextChunk, Document]
+    to: Entity
+    relation: mentions_entity
+
+  RELATED_TO:
+    from: Entity
+    to: Entity
+    relation: related_to

contextsynapse/config/schemas/support_ticket.yaml

@@ -0,0 +1,48 @@
+# Support Ticket Extraction Schema
+# Used when ingesting customer support tickets, bug reports, and helpdesk records.
+
+name: support_ticket
+
+node_types:
+  Customer:
+    fields: [name, email, account_id, tier, company]
+    required: [name]
+    description: "A customer who submitted the support ticket"
+
+  Issue:
+    fields: [title, description, severity, category, status, created_at, resolved_at]
+    required: [title]
+    description: "The problem or issue reported in the ticket"
+
+  Resolution:
+    fields: [description, steps, workaround, resolved_by, resolved_at]
+    required: [description]
+    description: "The solution or fix applied to resolve the issue"
+
+  Product:
+    fields: [name, version, platform, component]
+    required: [name]
+    description: "The product or service component affected by the issue"
+
+edge_types:
+  REPORTED:
+    source: Customer
+    target: Issue
+  RESOLVED_BY:
+    source: Issue
+    target: Resolution
+  AFFECTS:
+    source: Issue
+    target: Product
+  RELATED_TO:
+    source: Issue
+    target: Issue
+
+fact_types:
+  - type: RootCause
+    fields: [description, category, source_text]
+    description: "The identified root cause of the reported issue"
+
+  - type: StepsToReproduce
+    fields: [steps, environment, source_text]
+    description: "Steps required to reproduce the issue"

contextsynapse/config/schemas/web.yaml

@@ -0,0 +1,64 @@
+# Web Content Extraction Schema
+# Used when ingesting web pages, API docs, blog posts, and external
+# references into a web context.
+
+name: web
+
+node_types:
+  WebPage:
+    fields: [title, url, description, published_date, language]
+    required: [title]
+    description: "A web page, blog post, or online article"
+
+  Article:
+    fields: [title, author, published_date, summary, category, tags]
+    required: [title]
+    description: "A structured article or blog post with clear authorship"
+
+  Author:
+    fields: [name, url, affiliation, bio]
+    required: [name]
+    description: "An author, blogger, or content creator"
+
+  Entity:
+    fields: [name, type, description, url]
+    required: [name]
+    description: "A named entity mentioned in web content (product, service, place, event)"
+
+  Organization:
+    fields: [name, type, url, description]
+    required: [name]
+    description: "A company, institution, or organization referenced in content"
+
+edge_types:
+  LINKS_TO:
+    source: WebPage
+    target: WebPage
+  AUTHORED_BY:
+    source: Article
+    target: Author
+  MENTIONS:
+    source: WebPage
+    target: Entity
+  PUBLISHED_BY:
+    source: Article
+    target: Organization
+  CITES:
+    source: Article
+    target: Article
+  AFFILIATED_WITH:
+    source: Author
+    target: Organization
+
+fact_types:
+  - type: Claim
+    fields: [statement, confidence, source_url, source_text]
+    description: "A factual claim made in the web content"
+
+  - type: Statistic
+    fields: [name, value, unit, date, source_url, source_text]
+    description: "A numerical statistic or data point cited in the content"
+
+  - type: Date
+    fields: [event, date, description, source_text]
+    description: "A significant date or event mentioned in the content"

contextsynapse/config/sensors/earnings_calendar.yaml

@@ -0,0 +1,52 @@
+name: Earnings Calendar
+description: "Quarterly earnings dates, results, guidance — pre and post earnings signals"
+type: calendar
+version: "1.0"
+active: true
+
+connector:
+  type: rss
+  sources:
+    - "https://economictimes.indiatimes.com/markets/rssfeeds/1977021501.cms"
+    - "https://www.moneycontrol.com/rss/results.xml"
+  schedule: "0 */2 * * *"
+  poll_interval_minutes: 120
+  filter:
+    topics:
+      - quarterly results
+      - Q1 results
+      - Q2 results
+      - Q3 results
+      - Q4 results
+      - earnings
+      - profit
+      - revenue
+      - guidance
+      - board meeting
+      - dividend
+    exclude:
+      - cricket
+
+schema:
+  node_type: EarningsSignal
+  fields:
+    company: { type: string }
+    quarter: { type: string }
+    revenue: { type: float }
+    profit: { type: float }
+    surprise: { type: enum, values: [beat, miss, inline] }
+  extraction_strategy: news_article
+
+hierarchy:
+  affects_sectors: []
+  upstream_of: ""
+  weight: 0.8
+  level: market
+
+decay:
+  rate: 0.05
+  profile: earnings_season
+
+relevance:
+  sectors: []
+  keywords: ["earnings", "results", "guidance", "profit", "revenue", "EPS"]