import type { AiAgentDefinition } from '@open-mercato/ai-assistant/modules/ai_assistant/lib/ai-agent-definition'
// Import skills FIRST so `defineSkill` has populated the registry before any
// `defineAgent` below resolves its declared `skills`.
import './ai-skills'
import { defineAgent } from './lib/sdk/defineAgent'
import { dealHealthCheckResult } from './data/validators'

// `deals.health_check` is the demo agent for the MVP end-to-end flow (area 05).
// Authoring is code (here), not a DB seed: the ai_assistant generator discovers
// `ai-agents.ts` and `defineAgent` emits a standard AiAgentDefinition (object
// mode) while registering { id, resultKind, schema } in the area-01 registry.
// The id is the STABLE contract id referenced by the demo workflow definition's
// INVOKE_AGENT step (`examples/deals-health-check-workflow.json`) and the
// runbook in mvp/05-seed-and-demo.md.
//
// Result: an `proposal` proposal carrying a single `set_stage` action plus a
// confidence score. The disposition gate (area 03) auto-approves when
// `confidence >= autoApproveThreshold` (0.8 on the demo node) and otherwise
// raises a USER_TASK / proposal for an operator. The effector step applies the
// approved `set_stage` payload to the deal via the audited customers command.
export const aiAgents: AiAgentDefinition[] = [
  defineAgent({
    id: 'deals.health_check',
    moduleId: 'agent_orchestrator',
    label: 'Deal health check',
    description: 'Assess a deal’s health and propose the single best next stage.',
    instructions: [
      'You assess the health of a sales deal and propose the single best next pipeline stage.',
      'The input may contain the deal inline as `deal` (fields such as id, name, stage, value,',
      'probability, daysInStage and recentActivity) OR just a `dealId`. When you are given a',
      '`dealId` (or only an `id`) and not a full `deal`, call the `customers.get_deal` tool with',
      'that id to fetch the deal before assessing it; pass `includeRelated: true` to also load its',
      'recent activities and notes. This is a READ-only tool — you can look the deal up but you can',
      'never modify it; the only way to change the deal is the proposal you return.',
      'If the deal is already provided inline, use it directly and do not call the tool.',
      'Always return a proposal with exactly one `set_stage` action whose payload sets',
      'the next pipeline stage, e.g. { "type": "set_stage", "payload": { "stage": "Qualified" } }.',
      'Set `confidence` between 0 and 1: high (>= 0.8) when the next stage is unambiguous (strong',
      'probability, recent activity, healthy time-in-stage); lower (< 0.8) when a human should',
      'review (stalled deal, low probability, long time in stage). Use `rationale` to briefly',
      'explain the recommendation.',
      'Every field is REQUIRED: always return `confidence` (a number between 0 and 1), a non-empty',
      '`rationale`, and exactly one set_stage action whose `payload.stage` is a non-empty pipeline',
      'stage name (e.g. "Negotiation"). Never return an empty stage or omit confidence.',
    ].join(' '),
    // Read-only tool: lets the agent fetch the deal by id (gated by
    // customers.deals.view, checked against the caller's own ACL). Propose-only
    // is preserved — the agent is declared read-only, so the runtime strips any
    // mutation tool; the only way it can change a deal is the proposal it emits.
    tools: ['customers.get_deal'],
    // The skill injects the pipeline-stage playbook into the prompt AND
    // contributes its read-only `customers.analyze_deals` tool to this agent.
    skills: ['deals.stage_playbook'],
    result: { kind: 'proposal', schema: dealHealthCheckResult },
    // Inline `deal` so the Playground runs deterministically (no DB lookup).
    sampleInput: {
      deal: {
        id: 'demo-deal-1',
        name: 'Acme Corp — Enterprise plan',
        stage: 'Proposal',
        value: 48000,
        probability: 0.65,
        daysInStage: 12,
        recentActivity: 'Sent revised pricing; awaiting procurement sign-off.',
      },
    },
  }),
]

export default aiAgents