paperclip-plugin-autopilot-ops 0.1.6 → 0.1.7

package/dist/manifest.js

@@ -1,6 +1,6 @@
 // src/manifest.ts
 var PLUGIN_ID = "alephoo.autopilot-ops";
-var PLUGIN_VERSION = "0.1.6";
+var PLUGIN_VERSION = "0.1.7";
 var DB_NAMESPACE_SLUG = "autopilot_ops";
 var PAGE_ROUTE = "autopilot";
 var TOOL_NAMES = {
@@ -101,7 +101,7 @@ var manifest = {
     {
       name: TOOL_NAMES.transicionar,
       displayName: "Transicionar caso",
-      description: "Aplica una transici\xF3n del workflow al caso (p. ej. `proponer`, `aplicar`, `verificar`). El plugin valida contra la tabla de transiciones, la pol\xEDtica vigente (observa / propone / ejecuta / corte) y las reglas de negocio; si algo falla, el caso no cambia y se devuelve el motivo. Las transiciones humanas (aprobar, rechazar, corregir) no est\xE1n disponibles para agentes. Cuando una persona del hospital carga a mano lo aprobado, el caso queda en `aplicado`: el agente lo comprueba releyendo el sistema y llamando `verificar` con `datos.valor_leido`. En `recupero_turno`: `proponer` con solicitud_id, solicitud_estado, solicitud_especialidad, cola (la lista de espera pendiente de esa especialidad tal como se vio: [{solicitud_id, prioridad, alta}]; el plugin la ordena y exige justificaci\xF3n para no elegir la primera) y fuente; `asignar` con accion_id; `verificar` con leido_fecha, leido_hora, leido_profesional y leido_solicitud_id; `sin_candidato` y `descartar` con motivo.",
+      description: "Aplica una transici\xF3n del workflow al caso (p. ej. `proponer`, `aplicar`, `verificar`). El plugin valida contra la tabla de transiciones, la pol\xEDtica vigente (observa / propone / ejecuta / corte) y las reglas de negocio; si algo falla, el caso no cambia y se devuelve el motivo. Las transiciones humanas (aprobar, rechazar, corregir) no est\xE1n disponibles para agentes. Cuando una persona del hospital carga a mano lo aprobado, el caso queda en `aplicado`: el agente lo comprueba releyendo el sistema y llamando `verificar` con `datos.valor_leido`. En `recupero_turno`: `proponer` con solicitud_id, solicitud_estado, solicitud_especialidad, cola (la lista de espera pendiente de esa especialidad tal como se vio: [{solicitud_id, prioridad, alta}]; el plugin la ordena y exige justificaci\xF3n para no elegir la primera) y fuente; si la instituci\xF3n pide consulta previa (ops_leer_caso lo dice), `ofrecer` con canal y esperar `aceptar`/`no_acepta`; **antes de escribir en el sistema, `autorizar`** (sin esa autorizaci\xF3n no se escribe); despu\xE9s de escribir, `asignar` con accion_id; `verificar` con leido_fecha, leido_hora, leido_profesional y leido_solicitud_id; `sin_candidato` y `descartar` con motivo.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -221,6 +221,14 @@ var manifest = {
       capability: "api.routes.register",
       companyResolution: { from: "body", key: "companyId" }
     },
+    {
+      routeKey: "respuesta-paciente",
+      method: "POST",
+      path: "/casos/:casoId/respuesta",
+      auth: "board",
+      capability: "api.routes.register",
+      companyResolution: { from: "body", key: "companyId" }
+    },
     {
       routeKey: "version",
       method: "GET",

package/dist/ui/index.js

@@ -8,7 +8,7 @@ import {
 
 // src/manifest.ts
 var PLUGIN_ID = "alephoo.autopilot-ops";
-var PLUGIN_VERSION = "0.1.6";
+var PLUGIN_VERSION = "0.1.7";
 var DB_NAMESPACE_SLUG = "autopilot_ops";
 var PAGE_ROUTE = "autopilot";
 var TOOL_NAMES = {
@@ -109,7 +109,7 @@ var manifest = {
     {
       name: TOOL_NAMES.transicionar,
       displayName: "Transicionar caso",
-      description: "Aplica una transici\xF3n del workflow al caso (p. ej. `proponer`, `aplicar`, `verificar`). El plugin valida contra la tabla de transiciones, la pol\xEDtica vigente (observa / propone / ejecuta / corte) y las reglas de negocio; si algo falla, el caso no cambia y se devuelve el motivo. Las transiciones humanas (aprobar, rechazar, corregir) no est\xE1n disponibles para agentes. Cuando una persona del hospital carga a mano lo aprobado, el caso queda en `aplicado`: el agente lo comprueba releyendo el sistema y llamando `verificar` con `datos.valor_leido`. En `recupero_turno`: `proponer` con solicitud_id, solicitud_estado, solicitud_especialidad, cola (la lista de espera pendiente de esa especialidad tal como se vio: [{solicitud_id, prioridad, alta}]; el plugin la ordena y exige justificaci\xF3n para no elegir la primera) y fuente; `asignar` con accion_id; `verificar` con leido_fecha, leido_hora, leido_profesional y leido_solicitud_id; `sin_candidato` y `descartar` con motivo.",
+      description: "Aplica una transici\xF3n del workflow al caso (p. ej. `proponer`, `aplicar`, `verificar`). El plugin valida contra la tabla de transiciones, la pol\xEDtica vigente (observa / propone / ejecuta / corte) y las reglas de negocio; si algo falla, el caso no cambia y se devuelve el motivo. Las transiciones humanas (aprobar, rechazar, corregir) no est\xE1n disponibles para agentes. Cuando una persona del hospital carga a mano lo aprobado, el caso queda en `aplicado`: el agente lo comprueba releyendo el sistema y llamando `verificar` con `datos.valor_leido`. En `recupero_turno`: `proponer` con solicitud_id, solicitud_estado, solicitud_especialidad, cola (la lista de espera pendiente de esa especialidad tal como se vio: [{solicitud_id, prioridad, alta}]; el plugin la ordena y exige justificaci\xF3n para no elegir la primera) y fuente; si la instituci\xF3n pide consulta previa (ops_leer_caso lo dice), `ofrecer` con canal y esperar `aceptar`/`no_acepta`; **antes de escribir en el sistema, `autorizar`** (sin esa autorizaci\xF3n no se escribe); despu\xE9s de escribir, `asignar` con accion_id; `verificar` con leido_fecha, leido_hora, leido_profesional y leido_solicitud_id; `sin_candidato` y `descartar` con motivo.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -229,6 +229,14 @@ var manifest = {
       capability: "api.routes.register",
       companyResolution: { from: "body", key: "companyId" }
     },
+    {
+      routeKey: "respuesta-paciente",
+      method: "POST",
+      path: "/casos/:casoId/respuesta",
+      auth: "board",
+      capability: "api.routes.register",
+      companyResolution: { from: "body", key: "companyId" }
+    },
     {
       routeKey: "version",
       method: "GET",

package/dist/worker.js

@@ -39932,7 +39932,7 @@ function startWorkerRpcHost(options) {
 
 // src/manifest.ts
 var PLUGIN_ID = "alephoo.autopilot-ops";
-var PLUGIN_VERSION = "0.1.6";
+var PLUGIN_VERSION = "0.1.7";
 var DB_NAMESPACE_SLUG = "autopilot_ops";
 var PAGE_ROUTE = "autopilot";
 var TOOL_NAMES = {
@@ -40033,7 +40033,7 @@ var manifest = {
     {
       name: TOOL_NAMES.transicionar,
       displayName: "Transicionar caso",
-      description: "Aplica una transici\xF3n del workflow al caso (p. ej. `proponer`, `aplicar`, `verificar`). El plugin valida contra la tabla de transiciones, la pol\xEDtica vigente (observa / propone / ejecuta / corte) y las reglas de negocio; si algo falla, el caso no cambia y se devuelve el motivo. Las transiciones humanas (aprobar, rechazar, corregir) no est\xE1n disponibles para agentes. Cuando una persona del hospital carga a mano lo aprobado, el caso queda en `aplicado`: el agente lo comprueba releyendo el sistema y llamando `verificar` con `datos.valor_leido`. En `recupero_turno`: `proponer` con solicitud_id, solicitud_estado, solicitud_especialidad, cola (la lista de espera pendiente de esa especialidad tal como se vio: [{solicitud_id, prioridad, alta}]; el plugin la ordena y exige justificaci\xF3n para no elegir la primera) y fuente; `asignar` con accion_id; `verificar` con leido_fecha, leido_hora, leido_profesional y leido_solicitud_id; `sin_candidato` y `descartar` con motivo.",
+      description: "Aplica una transici\xF3n del workflow al caso (p. ej. `proponer`, `aplicar`, `verificar`). El plugin valida contra la tabla de transiciones, la pol\xEDtica vigente (observa / propone / ejecuta / corte) y las reglas de negocio; si algo falla, el caso no cambia y se devuelve el motivo. Las transiciones humanas (aprobar, rechazar, corregir) no est\xE1n disponibles para agentes. Cuando una persona del hospital carga a mano lo aprobado, el caso queda en `aplicado`: el agente lo comprueba releyendo el sistema y llamando `verificar` con `datos.valor_leido`. En `recupero_turno`: `proponer` con solicitud_id, solicitud_estado, solicitud_especialidad, cola (la lista de espera pendiente de esa especialidad tal como se vio: [{solicitud_id, prioridad, alta}]; el plugin la ordena y exige justificaci\xF3n para no elegir la primera) y fuente; si la instituci\xF3n pide consulta previa (ops_leer_caso lo dice), `ofrecer` con canal y esperar `aceptar`/`no_acepta`; **antes de escribir en el sistema, `autorizar`** (sin esa autorizaci\xF3n no se escribe); despu\xE9s de escribir, `asignar` con accion_id; `verificar` con leido_fecha, leido_hora, leido_profesional y leido_solicitud_id; `sin_candidato` y `descartar` con motivo.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -40153,6 +40153,14 @@ var manifest = {
       capability: "api.routes.register",
       companyResolution: { from: "body", key: "companyId" }
     },
+    {
+      routeKey: "respuesta-paciente",
+      method: "POST",
+      path: "/casos/:casoId/respuesta",
+      auth: "board",
+      capability: "api.routes.register",
+      companyResolution: { from: "body", key: "companyId" }
+    },
     {
       routeKey: "version",
       method: "GET",
@@ -40470,6 +40478,26 @@ function fueraDePreferencia(preferencia, hora) {
   if (p.includes("tarde")) return hora < "13:00";
   return false;
 }
+var MARGEN_MINUTOS_ASIGNAR = 60;
+function minutosHastaLaCita(l, contexto) {
+  const hora = horaHM(l.hora);
+  if (!fechaISO(l.fecha) || !hora || !contexto.hoy || !contexto.horaActual) return null;
+  const cita = Date.parse(`${String(l.fecha)}T${hora}:00Z`);
+  const ahora = Date.parse(`${contexto.hoy}T${contexto.horaActual}:00Z`);
+  return Number.isNaN(cita) || Number.isNaN(ahora) ? null : Math.round((cita - ahora) / 6e4);
+}
+function validarMargen(caso, contexto) {
+  const minutos = minutosHastaLaCita(caso.datos, contexto);
+  if (minutos === null) return ok("margen_para_avisar", "sin fecha y hora para medir");
+  return minutos >= MARGEN_MINUTOS_ASIGNAR ? ok("margen_para_avisar", `faltan ${minutos} min`) : falla("margen_para_avisar", minutos <= 0 ? "la cita ya pas\xF3" : `la cita es en ${minutos} min: hacen falta al menos ${MARGEN_MINUTOS_ASIGNAR} para que el paciente se entere`);
+}
+function validarPacienteAcepto(caso, contexto) {
+  if (!contexto.ofrecerPrimero) return ok("paciente_acepto", "la instituci\xF3n no pide consulta previa");
+  return caso.estado === "aceptado" ? ok("paciente_acepto", "el paciente acept\xF3") : falla("paciente_acepto", "en esta instituci\xF3n el paciente tiene que aceptar la cita antes de asignarla: primero ofrecer y esperar que acepte");
+}
+function declinadas(caso) {
+  return Array.isArray(caso.datos.declinaron) ? caso.datos.declinaron.map((v) => refExterna(v)).filter((v) => v !== null) : [];
+}
 function validarLugar(caso, datos, contexto) {
   const l = { ...caso.datos, ...datos };
   const completo = fechaISO(l.fecha) && horaHM(l.hora) !== null && texto(l.profesional) !== null && texto(l.especialidad) !== null;
@@ -40484,7 +40512,7 @@ function validarLugar(caso, datos, contexto) {
 }
 var recuperoTurno = {
   clave: "recupero_turno",
-  nombre: "Recupero de turnos liberados",
+  nombre: "Recupero de citas",
   puesto: "Pacientes y agenda",
   descripcion: "Detecta un turno que se liber\xF3 en la agenda, elige de la lista de espera (solicitudes de turno) a quien corresponde por especialidad, prioridad y antig\xFCedad, le asigna el turno en el sistema de gesti\xF3n y comprueba reley\xE9ndolo que qued\xF3 asignado.",
   inicial: "detectado",
@@ -40494,6 +40522,7 @@ var recuperoTurno = {
     "aprobado",
     "ofrecido",
     "aceptado",
+    "asignando",
     "asignado",
     "verificado",
     "con_diferencias",
@@ -40522,7 +40551,10 @@ var recuperoTurno = {
         const espSolicitud = normalizarNombre(datos.solicitud_especialidad);
         out.push(esp && espSolicitud && esp === espSolicitud ? ok("especialidad_coincide") : falla("especialidad_coincide", `la solicitud es de ${texto(datos.solicitud_especialidad) ?? "(sin especialidad)"} y el turno es de ${texto(l.especialidad) ?? "(sin especialidad)"}`));
         out.push(contexto.solicitudEnOtroCaso ? falla("solicitud_libre", `esa solicitud ya tiene otro recupero en curso o asignado (${contexto.solicitudEnOtroCaso})`) : ok("solicitud_libre"));
-        const { posicion, total } = posicionEnCola(datos, contexto.solicitudesEnCurso);
+        const yaNo = declinadas(caso);
+        const elegida = refExterna(datos.solicitud_id);
+        out.push(elegida && yaNo.includes(elegida) ? falla("no_la_rechazo", "el paciente de esa solicitud ya no acept\xF3 esta cita: proponer a la siguiente") : ok("no_la_rechazo"));
+        const { posicion, total } = posicionEnCola(datos, [...contexto.solicitudesEnCurso ?? [], ...yaNo]);
         if (!leerCola(datos.cola)) out.push(falla("orden_de_la_cola", "cola es obligatoria: la lista de espera pendiente de esa especialidad tal como se vio, [{solicitud_id, prioridad, alta}]"));
         else if (posicion === null) out.push(falla("orden_de_la_cola", "la solicitud elegida no est\xE1 en la cola informada"));
         else if (posicion > 1 && !texto(datos.justificacion)) out.push(falla("orden_de_la_cola", `es la ${posicion}.\xAA de ${total} en la cola: pasarla adelante de las anteriores requiere justificacion`));
@@ -40534,7 +40566,7 @@ var recuperoTurno = {
         aSinExcepcion: "aprobado",
         excepciones: (caso, datos, contexto) => {
           const l = { ...caso.datos, ...datos };
-          const { posicion, total } = posicionEnCola(datos, contexto.solicitudesEnCurso);
+          const { posicion, total } = posicionEnCola(datos, [...contexto.solicitudesEnCurso ?? [], ...declinadas(caso)]);
           const pedido = normalizarNombre(datos.solicitud_profesional);
           const profesional = normalizarNombre(l.profesional);
           const paraHoy = Boolean(contexto.hoy && l.fecha === contexto.hoy);
@@ -40574,8 +40606,11 @@ var recuperoTurno = {
       a: "ofrecido",
       actor: ["agente", "humano"],
       nivelRequerido: "ejecuta",
-      descripcion: "Ofrecerle el turno al paciente antes de asignarlo (paso opcional seg\xFAn el hospital).",
-      validar: (_caso, datos) => [texto(datos.canal) ? ok("canal_informado") : falla("canal_informado", "ofrecer requiere canal (tel\xE9fono, WhatsApp, correo)")]
+      descripcion: "Ofrecerle la cita al paciente antes de asignarla (obligatorio donde la instituci\xF3n pide consulta previa).",
+      validar: (caso, datos, contexto) => [
+        texto(datos.canal) ? ok("canal_informado") : falla("canal_informado", "ofrecer requiere canal (tel\xE9fono, WhatsApp, correo)"),
+        validarMargen(caso, contexto)
+      ]
     },
     {
       via: "aceptar",
@@ -40596,16 +40631,34 @@ var recuperoTurno = {
       validar: (_caso, datos) => [texto(datos.motivo) ? ok("motivo_presente") : falla("motivo_presente", "no_acepta requiere motivo (no contest\xF3, no puede ese d\xEDa\u2026)")]
     },
     {
-      via: "asignar",
+      // El plugin autoriza ANTES de que se escriba en el sistema del hospital: la cita está a tiempo
+      // y, donde la institución lo pide, el paciente aceptó. Sin esta autorización el agente no escribe.
+      via: "autorizar",
       de: ["aprobado", "aceptado"],
+      a: "asignando",
+      actor: ["agente", "humano"],
+      nivelRequerido: "ejecuta",
+      descripcion: "Pedir autorizaci\xF3n para asignar la cita en el sistema de gesti\xF3n. Va siempre antes de escribir.",
+      validar: (caso, _datos, contexto) => [
+        ...validarLugar(caso, {}, contexto),
+        validarMargen(caso, contexto),
+        validarPacienteAcepto(caso, contexto)
+      ]
+    },
+    {
+      // Registra lo que ya se escribió: no se rechaza por la hora (la escritura ocurrió). Un agente solo
+      // llega acá con la autorización; una persona que lo hizo a mano, desde aprobado o aceptado.
+      via: "asignar",
+      de: ["asignando", "aprobado", "aceptado"],
       a: "asignado",
       actor: ["agente", "humano"],
       nivelRequerido: "ejecuta",
       cargaManual: true,
-      descripcion: "Dar el turno a la solicitud aprobada en el sistema de gesti\xF3n y registrar la acci\xF3n.",
+      descripcion: "Registrar la cita asignada en el sistema de gesti\xF3n, con la acci\xF3n de escritura.",
       validar: (caso, datos, contexto) => [
-        ...validarLugar(caso, {}, contexto),
-        texto(datos.accion_id) ? ok("accion_registrada") : falla("accion_registrada", "asignar requiere accion_id de la escritura registrada con ops_registrar_accion")
+        texto(datos.accion_id) ? ok("accion_registrada") : falla("accion_registrada", "asignar requiere accion_id de la escritura registrada con ops_registrar_accion"),
+        contexto.actor === "agente" && caso.estado !== "asignando" ? falla("escritura_autorizada", "un agente tiene que pedir autorizar antes de escribir en el sistema") : ok("escritura_autorizada"),
+        ...caso.estado === "asignando" ? [] : [validarPacienteAcepto(caso, contexto)]
       ]
     },
     {
@@ -40645,7 +40698,7 @@ var recuperoTurno = {
     },
     {
       via: "descartar",
-      de: ["detectado", "pendiente_aprobacion", "aprobado", "ofrecido", "aceptado"],
+      de: ["detectado", "pendiente_aprobacion", "aprobado", "ofrecido", "aceptado", "asignando"],
       a: "cancelado",
       actor: ["agente", "humano"],
       nivelRequerido: "observa",
@@ -40674,7 +40727,7 @@ function modoHabilita(modo, nivelRequerido) {
 function evaluarTransicion(input2) {
   const { caso, via, actor } = input2;
   const datos = input2.datos ?? {};
-  const contexto = input2.contexto ?? {};
+  const contexto = { ...input2.contexto ?? {}, actor };
   const wf = getWorkflow(caso.workflow);
   if (!wf) {
     return { ok: false, codigo: "workflow_desconocido", motivo: `workflow desconocido: ${caso.workflow}`, validaciones: [] };
@@ -40840,9 +40893,16 @@ async function obtenerModo(ctx, companyId, workflow) {
   const modo = rows[0]?.modo;
   return typeof modo === "string" ? modo : MODO_POR_DEFECTO;
 }
+async function obtenerOpciones(ctx, companyId, workflow) {
+  const rows = await ctx.db.query(
+    `SELECT opciones FROM ${t(ctx, "politica")} WHERE company_id = $1 AND workflow = $2 LIMIT 1`,
+    [companyId, workflow]
+  );
+  return jsonb(rows[0]?.opciones);
+}
 async function listarPoliticas(ctx, companyId) {
   const rows = await ctx.db.query(
-    `SELECT workflow, modo, motivo, updated_at FROM ${t(ctx, "politica")} WHERE company_id = $1`,
+    `SELECT workflow, modo, motivo, opciones, updated_at FROM ${t(ctx, "politica")} WHERE company_id = $1`,
     [companyId]
   );
   const porWorkflow = new Map(rows.map((r) => [String(r.workflow), r]));
@@ -40855,40 +40915,50 @@ async function listarPoliticas(ctx, companyId) {
       modo: r ? String(r.modo) : MODO_POR_DEFECTO,
       motivo: r ? r.motivo ?? null : null,
       actualizadaEn: r ? iso(r.updated_at) : null,
-      porDefecto: !r
+      porDefecto: !r,
+      opciones: r ? jsonb(r.opciones) : {}
     };
   });
 }
+function describirOpciones(antes, despues) {
+  const partes = [];
+  if (Boolean(antes.ofrecer_primero) !== Boolean(despues.ofrecer_primero)) partes.push(`consultar al paciente antes de asignar: ${despues.ofrecer_primero ? "s\xED" : "no"}`);
+  return partes.length ? partes.join(" \xB7 ") : null;
+}
 async function cambiarPolitica(ctx, input2) {
   if (!getWorkflow(input2.workflow)) throw new OpsError("workflow_desconocido", `workflow desconocido: ${input2.workflow}`);
   if (input2.actor.tipo !== "humano") throw new OpsError("actor_no_permitido", "solo un humano puede cambiar la pol\xEDtica de un workflow");
   const anterior = await obtenerModo(ctx, input2.companyId, input2.workflow);
+  const opcionesAntes = await obtenerOpciones(ctx, input2.companyId, input2.workflow);
+  const opciones = { ...opcionesAntes, ...input2.opciones ?? {} };
+  const cambioOpciones = describirOpciones(opcionesAntes, opciones);
+  const motivo = [input2.motivo ?? null, cambioOpciones].filter(Boolean).join(" \xB7 ") || null;
   const existe = await ctx.db.query(
     `SELECT id FROM ${t(ctx, "politica")} WHERE company_id = $1 AND workflow = $2 LIMIT 1`,
     [input2.companyId, input2.workflow]
   );
   if (existe.length > 0) {
     await ctx.db.execute(
-      `UPDATE ${t(ctx, "politica")} SET modo = $3, motivo = $4, actor_tipo = $5, actor_id = $6, updated_at = now() WHERE company_id = $1 AND workflow = $2`,
-      [input2.companyId, input2.workflow, input2.modo, input2.motivo ?? null, input2.actor.tipo, input2.actor.id]
+      `UPDATE ${t(ctx, "politica")} SET modo = $3, motivo = $4, actor_tipo = $5, actor_id = $6, opciones = $7::jsonb, updated_at = now() WHERE company_id = $1 AND workflow = $2`,
+      [input2.companyId, input2.workflow, input2.modo, motivo, input2.actor.tipo, input2.actor.id, JSON.stringify(opciones)]
     );
   } else {
     await ctx.db.execute(
-      `INSERT INTO ${t(ctx, "politica")} (id, company_id, workflow, modo, motivo, actor_tipo, actor_id) VALUES ($1, $2, $3, $4, $5, $6, $7)`,
-      [randomUUID(), input2.companyId, input2.workflow, input2.modo, input2.motivo ?? null, input2.actor.tipo, input2.actor.id]
+      `INSERT INTO ${t(ctx, "politica")} (id, company_id, workflow, modo, motivo, actor_tipo, actor_id, opciones) VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb)`,
+      [randomUUID(), input2.companyId, input2.workflow, input2.modo, motivo, input2.actor.tipo, input2.actor.id, JSON.stringify(opciones)]
     );
   }
   await ctx.db.execute(
     `INSERT INTO ${t(ctx, "politica_historial")} (id, company_id, workflow, modo_anterior, modo_nuevo, motivo, actor_tipo, actor_id) VALUES ($1, $2, $3, $4, $5, $6, $7, $8)`,
-    [randomUUID(), input2.companyId, input2.workflow, anterior, input2.modo, input2.motivo ?? null, input2.actor.tipo, input2.actor.id]
+    [randomUUID(), input2.companyId, input2.workflow, anterior, input2.modo, motivo, input2.actor.tipo, input2.actor.id]
   );
   await ctx.activity.log({
     companyId: input2.companyId,
-    message: `Autopilot Care: pol\xEDtica de ${input2.workflow} cambiada de ${anterior} a ${input2.modo}${input2.motivo ? ` (${input2.motivo})` : ""}`,
+    message: `Autopilot Care: pol\xEDtica de ${input2.workflow} cambiada de ${anterior} a ${input2.modo}${motivo ? ` (${motivo})` : ""}`,
     metadata: { workflow: input2.workflow, modoAnterior: anterior, modoNuevo: input2.modo, actorId: input2.actor.id }
   });
   const wf = getWorkflow(input2.workflow);
-  return { workflow: wf.clave, nombre: wf.nombre, puesto: wf.puesto, modo: input2.modo, motivo: input2.motivo ?? null, actualizadaEn: (/* @__PURE__ */ new Date()).toISOString(), porDefecto: false };
+  return { workflow: wf.clave, nombre: wf.nombre, puesto: wf.puesto, modo: input2.modo, motivo, actualizadaEn: (/* @__PURE__ */ new Date()).toISOString(), porDefecto: false, opciones };
 }
 async function leerCaso(ctx, companyId, casoId) {
   const rows = await ctx.db.query(
@@ -41005,7 +41075,9 @@ function ahoraEnHospital(ahora = /* @__PURE__ */ new Date()) {
 async function contextoDe(ctx, companyId, caso, via, datos) {
   const { hoy, hora, inicioDelDia } = ahoraEnHospital();
   const contexto = { hoy, horaActual: hora };
-  if (caso.workflow !== "recupero_turno" || via !== "proponer") return contexto;
+  if (caso.workflow !== "recupero_turno") return contexto;
+  contexto.ofrecerPrimero = (await obtenerOpciones(ctx, companyId, caso.workflow)).ofrecer_primero === true;
+  if (via !== "proponer") return contexto;
   const otros = await ctx.db.query(
     `SELECT id, datos->>'solicitud_id' AS solicitud_id FROM ${t(ctx, "caso")} WHERE company_id = $1 AND workflow = $2 AND id <> $3 AND datos->>'solicitud_id' IS NOT NULL AND estado NOT IN ($4, $5, $6) LIMIT 1000`,
     [companyId, "recupero_turno", caso.id, "sin_candidato", "rechazado", "cancelado"]
@@ -41052,6 +41124,11 @@ async function transicionar(ctx, input2) {
       throw new OpsError("validacion", `accion_registrada: ${problema}`, { validaciones: [{ regla: "accion_registrada", ok: false, detalle: problema }], estado: caso.estado });
     }
   }
+  if (caso.workflow === "recupero_turno" && resultado.via === "no_acepta") {
+    const previas = Array.isArray(caso.datos.declinaron) ? caso.datos.declinaron.map((v) => refExterna(v)).filter((v) => v !== null) : [];
+    const esta = refExterna(caso.datos.solicitud_id);
+    datos.declinaron = esta && !previas.includes(esta) ? [...previas, esta] : previas;
+  }
   const excepcionesEvaluadas = resultado.validaciones.filter((v) => v.excepcion);
   if (excepcionesEvaluadas.length > 0) datos.excepciones = excepcionesEvaluadas.filter((v) => !v.ok).map((v) => v.regla);
   else if (resultado.via === "proponer") datos.excepciones = [];
@@ -41117,7 +41194,11 @@ async function registrarAccion(ctx, input2) {
     if (!modoHabilita(modo, "ejecuta")) throw new OpsError("politica", `la pol\xEDtica vigente de ${caso.workflow} es "${modo}": un agente no puede registrar escrituras sobre el sistema del hospital`);
   }
   const id = randomUUID();
-  const evidencia = input2.evidencia ?? {};
+  const evidencia = { ...input2.evidencia ?? {} };
+  delete evidencia.fuera_de_flujo;
+  if (caso.workflow === "recupero_turno" && input2.tipo === "escritura" && input2.actor.tipo === "agente" && caso.estado !== "asignando") {
+    evidencia.fuera_de_flujo = true;
+  }
   await ctx.db.execute(
     `INSERT INTO ${t(ctx, "accion")} (id, company_id, caso_id, tipo, conector, objetivo, resultado, evidencia, detalle, actor_tipo, actor_id, run_id) VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, $9, $10, $11, $12)`,
     [id, input2.companyId, caso.id, input2.tipo, input2.conector, objetivo, input2.resultado, JSON.stringify(evidencia), input2.detalle ?? null, input2.actor.tipo, input2.actor.id, input2.actor.runId ?? null]
@@ -41177,8 +41258,8 @@ async function registrarCargaManual(ctx, input2) {
   if (!sinValor && valorCargado === null) {
     throw new OpsError("validacion", "valor_cargado: debe ser un n\xFAmero", { validaciones: [{ regla: "valor_cargado_numerico", ok: false, detalle: "debe ser un n\xFAmero" }], estado: caso.estado });
   }
-  const { hoy, hora } = ahoraEnHospital();
-  const previa = evaluarTransicion({ caso, via: def2.via, actor: "humano", datos: { accion_id: "(por registrar)" }, modo: "ejecuta", contexto: { hoy, horaActual: hora } });
+  const contextoPrevio = await contextoDe(ctx, input2.companyId, caso, def2.via, {});
+  const previa = evaluarTransicion({ caso, via: def2.via, actor: "humano", datos: { accion_id: "(por registrar)" }, modo: "ejecuta", contexto: contextoPrevio });
   if (!previa.ok) throw new OpsError(previa.codigo, previa.motivo, { validaciones: previa.validaciones, estado: caso.estado });
   const persona = str(input2.persona);
   const comentario = str(input2.comentario);
@@ -41223,6 +41304,16 @@ async function registrarCargaManual(ctx, input2) {
     throw err;
   }
 }
+async function registrarRespuestaPaciente(ctx, input2) {
+  if (input2.actor.tipo !== "humano") throw new OpsError("actor_no_permitido", "la respuesta del paciente la registra una persona del hospital; un agente usa ops_transicionar");
+  const caso = await leerCaso(ctx, input2.companyId, input2.casoId);
+  if (!caso) throw new OpsError("caso_inexistente", `no existe el caso ${input2.casoId} en esta instituci\xF3n`);
+  if (caso.workflow !== "recupero_turno") throw new OpsError("estado_invalido", "solo las citas ofrecidas al paciente llevan respuesta");
+  const persona = str(input2.persona);
+  const comentario = str(input2.comentario);
+  const datos = input2.acepto ? { respuesta: comentario ?? "Acept\xF3 la cita", ...persona ? { registrado_por: persona } : {} } : { motivo: comentario ?? "No acept\xF3 la cita", ...persona ? { registrado_por: persona } : {} };
+  return transicionar(ctx, { companyId: input2.companyId, casoId: caso.id, via: input2.acepto ? "aceptar" : "no_acepta", datos, motivo: comentario, idempotencyKey: input2.idempotencyKey, actor: input2.actor });
+}
 function finalesOk() {
   return [...new Set(listarWorkflows().flatMap((w) => w.finalesOk))];
 }
@@ -41647,11 +41738,14 @@ function registrarHerramientas(ctx) {
     const detalle = await leerCasoCompleto(ctx, runCtx.companyId, casoId);
     if (!detalle) throw new OpsError("caso_inexistente", `no existe el caso ${casoId} en esta instituci\xF3n`);
     const disponibles = detalle.disponibles.filter((d) => d.actor.includes("agente")).map((d) => d.via);
+    const opciones = await obtenerOpciones(ctx, runCtx.companyId, detalle.caso.workflow);
+    const consulta = detalle.caso.workflow === "recupero_turno" ? `
+Consulta previa al paciente: ${opciones.ofrecer_primero === true ? "S\xCD (ofrecer y esperar que acepte antes de autorizar)" : "no"}` : "";
     return {
       content: `${resumenCaso(detalle.caso)}
 Transiciones disponibles para agente: ${disponibles.join(", ") || "ninguna"}
-Transiciones registradas: ${detalle.transiciones.length}; acciones registradas: ${detalle.acciones.length}`,
-      data: detalle
+Transiciones registradas: ${detalle.transiciones.length}; acciones registradas: ${detalle.acciones.length}${consulta}`,
+      data: { ...detalle, opciones }
     };
   }));
   ctx.tools.register(TOOL_NAMES.abrirCaso, toolSchema(TOOL_NAMES.abrirCaso), async (params, runCtx) => conErrores(async () => {
@@ -41836,8 +41930,10 @@ async function manejarApi(ctx, input2) {
       return respuesta(200, await transicionar(ctx, { companyId, casoId: input2.params.casoId ?? "", via: "rechazar", motivo: str2(body.motivo), datos: conPersona(obj(body.datos)), actor }));
     case "marcar-cargado":
       return respuesta(200, await registrarCargaManual(ctx, { companyId, casoId: input2.params.casoId ?? "", valorCargado: body.valorCargado, comentario: str2(body.comentario), persona: decididoPor, idempotencyKey: str2(body.idempotencyKey), actor }));
+    case "respuesta-paciente":
+      return respuesta(200, await registrarRespuestaPaciente(ctx, { companyId, casoId: input2.params.casoId ?? "", acepto: body.acepto === true, comentario: str2(body.comentario), persona: decididoPor, idempotencyKey: str2(body.idempotencyKey), actor }));
     case "version":
-      return respuesta(200, { version: manifest_default.version, capacidades: ["carga-manual", "recupero-turnos"], workflows: listarWorkflows().map((w) => w.clave) });
+      return respuesta(200, { version: manifest_default.version, capacidades: ["carga-manual", "recupero-turnos", "ofrecer-primero"], workflows: listarWorkflows().map((w) => w.clave) });
     case "politicas":
       return respuesta(200, { politicas: await listarPoliticas(ctx, companyId) });
     case "serie":
@@ -41854,7 +41950,8 @@ async function manejarApi(ctx, input2) {
       const workflow = str2(body.workflow);
       if (!workflow) return respuesta(400, { error: "workflow_requerido" });
       if (!esModo(body.modo)) return respuesta(400, { error: "modo_invalido", detalle: "modo debe ser corte, observa, propone, ejecuta o autonomo" });
-      return respuesta(200, await cambiarPolitica(ctx, { companyId, workflow, modo: body.modo, motivo: motivoConPersona(str2(body.motivo)), actor }));
+      const opciones = body.opciones && typeof body.opciones === "object" && !Array.isArray(body.opciones) ? body.opciones : null;
+      return respuesta(200, await cambiarPolitica(ctx, { companyId, workflow, modo: body.modo, motivo: motivoConPersona(str2(body.motivo)), opciones, actor }));
     }
     default:
       return respuesta(404, { error: "ruta_desconocida", routeKey: input2.routeKey });

package/migrations/003_opciones_politica.sql

@@ -0,0 +1,6 @@
+-- Opciones de cada función por institución, además del nivel de autonomía.
+-- recupero_turno: {"ofrecer_primero": true} → el paciente tiene que aceptar la cita
+-- antes de que se asigne (el plugin no autoriza la escritura hasta que acepta).
+
+ALTER TABLE plugin_autopilot_ops_1a68482ede.politica
+  ADD COLUMN opciones jsonb NOT NULL DEFAULT '{}'::jsonb;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperclip-plugin-autopilot-ops",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "description": "Autopilot Care · operación autónoma gobernada para instituciones de salud: workflows determinísticos, validaciones, registro de negocio, políticas (observa/propone/ejecuta/corte) y tablero del director, como plugin de Paperclip.",
   "files": [