Skip to content

PointSav Documentation

The engineering library for the PointSav platform — operating systems and services for regulated businesses that own their data, their AI, and their record-keeping outright. Where the monorepo holds the code, this wiki holds the reasoning: architecture, services, security, and the governance commitments that bind future development.

PointSav Digital Systems

Last updated · 8b931529 · English

Sesión Totebox

Una sesión Totebox es una sesión de colaborador asistida por IA abierta dentro de un único archivo Totebox. Tiene alcance a los repositorios declarados del archivo y no puede escribir fuera de ellos. Desde la perspectiva del colaborador, abrir una sesión Totebox es como comienza cada tarea de desarrollo en la orquestación Totebox. El protocolo de la sesión refleja la experiencia del cliente: el punto de entrada del colaborador en el espacio de trabajo y el punto de entrada del cliente a través de os-console realizan la misma función.

Este artículo describe cómo se abre una sesión, qué puede y no puede hacer, los cuatro niveles de permiso, y el protocolo de buzones de entrada y salida que coordina el trabajo entre archivos.

Cómo abrir una sesión

El punto de entrada previsto es el comando de consola open-archive, planificado para invocarse desde la sesión concentradora. Cuando se invoque, está previsto que:

  1. Lea el manifiesto del archivo
  2. Muestre el nombre del archivo, el estado de la tétrada, el punto final de la pasarela de IA y el recuento de mensajes pendientes en el buzón de entrada
  3. Verifique el nivel de permiso del colaborador contra el registro de personal (véase Personal y permisos)
  4. Establezca las variables de entorno del archivo
  5. Abra una sesión de IA en el directorio raíz del archivo

Esto refleja la experiencia del cliente: un miembro de la comunidad o un cliente abre un archivo Totebox a través de os-console. El flujo de trabajo de desarrollo utiliza el mismo punto de entrada, adaptado al espacio de trabajo.

Alcance de la sesión

Una sesión Totebox:

  • Escribe en cualquier repositorio declarado en el manifiesto del archivo
  • Confirma en la rama de staging del archivo (nunca directamente en main canónica)
  • Enruta la inferencia a través de la pasarela compartida de control de acceso service-slm (Doorman) usando el identificador de módulo del archivo
  • Envía solicitudes entre archivos como mensajes a la sesión concentradora (nunca escribe en otros archivos)
  • Almacena borradores del wiki en .agent/drafts-outbound/ para la canalización editorial

Una sesión Totebox no:

  • Escribe archivos de configuración o herramientas a nivel del espacio de trabajo
  • Escribe en el almacén de identidades
  • Accede directamente a los árboles fuente canónicos (esos reciben contenido por promoción, no por escritura directa)
  • Abre conexiones con sesiones de archivo hermanas

La tétrada del proyecto

Cada archivo Totebox declara cuatro patas de la tétrada del proyecto. El trabajo de una sesión contribuye a las cuatro:

Pata La sesión escribe en
vendor Código de característica en el clon pointsav-monorepo del archivo
customer Guías operativas en el clon woodfine-fleet-deployment del archivo
deployment Provisión de la instancia en ejecución en el directorio de despliegue
wiki Archivos de borrador TOPIC almacenados en .agent/drafts-outbound/

La sesión concentradora ratifica la completitud de la tétrada cuando las cuatro patas están presentes.

El protocolo de coordinación entre sesiones de IA

Las sesiones se comunican mediante el protocolo de archivos de buzones de entrada y salida:

  • Cada archivo contiene los archivos .agent/inbox.md y .agent/outbox.md
  • Una sesión Totebox lee su buzón de entrada al iniciar la sesión y archiva los mensajes accionados
  • Las solicitudes salientes a otros archivos o a la sesión concentradora se anteponen en .agent/outbox.md (más reciente arriba)
  • La sesión concentradora barre los buzones de salida del clúster durante la revisión del espacio de trabajo y enruta los mensajes

En la siguiente fase planificada, app-orchestration-command (CommandCentre) está previsto para intermediar todos los mensajes entre archivos por HTTP, con cada mensaje transitando automáticamente la pasarela de control de acceso y el libro mayor inmutable. El protocolo basado en archivos está previsto para permanecer como respaldo y como mecanismo en modo de desarrollo.

Niveles de permiso

Cuatro niveles rigen lo que un colaborador — y la sesión que abre — pueden hacer:

Nivel Etiqueta Conjunto de emparejamientos
P1 Administrador del sistema Concentrador + cada archivo + cada nodo de infraestructura
P2 Gerente de paquetes Archivos específicos más rutas de promoción de la etapa 6
P3 Usuario Archivos específicos; sin emparejamiento con el concentrador; solo lectura entre archivos
P4 Interfaz Solo superficie de API de solo lectura

Este es el nivel de permiso propio del colaborador, un concepto distinto del rol que otorga un token de emparejamiento de un archivo individual (véase Cómo emparejar un dispositivo nuevo) — el nivel de un colaborador rige lo que puede hacer en todo el espacio de trabajo; el rol de un token de emparejamiento rige lo que otorga ese emparejamiento específico con un archivo.

Los niveles se aplican mediante emparejamientos, no comparaciones de cadenas. El os-console de un colaborador P3 no está emparejado con el concentrador — la conexión no existe. Véase Emparejamiento como permiso para el mecanismo formal.

Relación con os-console

os-console es el punto de entrada orientado al cliente para abrir un archivo Totebox. En el espacio de trabajo de desarrollo, el comando open-archive es el equivalente. Ambos están previstos para realizar la misma función: leer el manifiesto del archivo, validar el alcance del permiso del colaborador, establecer el contexto de la sesión y abrir una sesión de trabajo dentro del archivo. El entorno de desarrollo utiliza el mismo patrón que el cliente está previsto a utilizar.

Véase también

Cite this record: /wiki/totebox-session — revision 8b931529, last updated 25 May 2026.

Important Information

Estructura corporativa. PointSav Digital Systems ("PointSav") es actualmente un nombre comercial de Woodfine Capital Projects Inc. ("Woodfine"), con previsión de convertirse en una subsidiaria de propiedad absoluta de Woodfine tras su incorporación. PointSav no ofrece, vende ni solicita por sí mismo valor alguno. Toda oferta de valores asociada a las soluciones inmobiliarias de tenencia directa de Woodfine se realiza exclusivamente por parte de Woodfine, y únicamente por medio del Memorando de Colocación Privada aplicable.

Sin asesoramiento de inversión. El contenido de este wiki se ofrece con fines de ingeniería, operativos, de investigación y de desarrollo. Nada de lo que figura en este wiki constituye asesoramiento de inversión ni una solicitud para invertir en ninguna sociedad o solución de tenencia directa de Woodfine.

Propiedad intelectual. El nombre, el nombre comercial, el logotipo y las marcas de PointSav, junto con todos los productos, servicios y ofertas actuales y futuros de las marcas PointSav y Totebox — así como el software, el código fuente, la documentación, el sistema de diseño y todos los materiales relacionados — son propiedad de Woodfine y sus filiales, salvo los componentes identificados como de código abierto. No se otorga ningún derecho salvo el expresamente establecido en una licencia o acuerdo por escrito. El aviso de marcas completo aparece en el pie de página de cada página de este sitio.

Componentes de código abierto. Algunas partes de la plataforma se ofrecen bajo licencias de código abierto permisivas identificadas en el repositorio correspondiente. El uso de esos componentes se rige por los términos de sus respectivas licencias.

Sin garantía; uso informativo. El contenido de este wiki se ofrece únicamente con fines informativos generales y no constituye una declaración, garantía ni compromiso respecto de la funcionalidad, disponibilidad, precio o hoja de ruta de ningún producto. Algunos artículos describen características, capacidades e hitos planificados o previstos — el lenguaje como "planificado", "previsto", "objetivo", "puede" y "esperado" marca este contenido prospectivo, que está sujeto a cambios y no constituye un compromiso respecto del rendimiento futuro.

Confidencialidad. Cuando un artículo describiría un detalle operativo o de implementación no destinado a divulgación pública, ese artículo no se publica en este wiki. El contenido aquí es documentación de ingeniería de uso general, no configuración específica de clientes.

Jurisdicción. Woodfine Capital Projects Inc. está constituida en Columbia Británica, Canadá. Las referencias a la Sovereign Data Foundation en este wiki describen una iniciativa planificada o prevista únicamente, no una titular de capital actual ni un órgano de gobierno activo.

Cambios a este aviso. PointSav podrá actualizar este aviso periódicamente; rige la versión publicada en esta página.

No es un sistema de presentación de documentos. Este wiki no es un sistema de presentación de valores, un repositorio de divulgación electrónica ni un sustituto de SEDAR+ ni de ningún otro sistema de presentación regulatorio. Las presentaciones formales de valores se realizan a través del sistema de presentación regulatorio correspondiente, no a través de este wiki.

Descargo completo. Este aviso complementa, y no sustituye, el artículo completo de Avisos Legales. En caso de cualquier conflicto, prevalece el artículo de Avisos Legales.

Read the full disclaimer →