ReasoningStep

ReasoningStep:

type: object

required:

- stepId

- description

- confidence

properties:

stepId:

type: string

description:

type: string

usedEntities:

type: array

nullable: true

items:

type: string

usedFacts:

type: array

nullable: true

items:

type: string

usedRules:

type: array

nullable: true

items:

type: string

intermediateResult:

nullable: true

confidence:

type: number

minimum: 0

maximum: 1

riskImpact:

$ref: '#/components/schemas/RiskLevel'

ReasoningConclusion:

type: object

required:

- summary

- confidence

properties:

summary:

type: string

detailed:

type: string

nullable: true

recommendations:

type: array

nullable: true

items:

$ref: '#/components/schemas/Recommendation'

confidence:

type: number

minimum: 0

maximum: 1

riskAssessment:

$ref: '#/components/schemas/RiskAssessment'

Recommendation:

type: object

required:

- description

properties:

actionId:

type: string

nullable: true

description:

type: string

expectedOutcome:

type: string

nullable: true

riskLevel:

$ref: '#/components/schemas/RiskLevel'

timeHorizonYears:

type: integer

nullable: true

RiskAssessment:

type: object

required:

- overallRisk

properties:

overallRisk:

$ref: '#/components/schemas/RiskLevel'

factors:

type: array

nullable: true

items:

$ref: '#/components/schemas/RiskFactor'

RiskFactor:

type: object

required:

- name

- riskLevel

- confidence

properties:

name:

type: string

description:

type: string

nullable: true

riskLevel:

$ref: '#/components/schemas/RiskLevel'

confidence:

type: number

minimum: 0

maximum: 1

# -------------------------------------------------

# MemoryLayer

# -------------------------------------------------

MemorySnapshot:

type: object

required:

- sessionId

- createdAt

- lastUpdatedAt

properties:

sessionId:

type: string

createdAt:

type: string

format: date-time

lastUpdatedAt:

type: string

format: date-time

shortTerm:

nullable: true

longTermRefs:

type: array

nullable: true

items:

$ref: '#/components/schemas/MemoryRef'

MemoryRef:

type: object

required:

- id

- type

properties:

id:

type: string

type:

type: string

enum: [DOCUMENT, MODEL, PROFILE, HISTORY]

tags:

type: array

nullable: true

items:

type: string

lastAccessedAt:

type: string

format: date-time

nullable: true

MemoryUpdate:

type: object

properties:

addShortTerm:

nullable: true

mergeShortTerm:

nullable: true

addLongTermRefs:

type: array

nullable: true

items:

$ref: '#/components/schemas/MemoryRef'

removeLongTermRefs:

type: array

nullable: true

items:

type: string

# -------------------------------------------------

# GuardLayer

# -------------------------------------------------