Skip to content
TCAFTask-Contract AI Development Framework
TCAF 0.3.3

Universal Run Protocol

Comprendi la Run Envelope versionata che collega una sola operazione, un target, un adapter e una superficie di istruzioni.

Contenuto: completeWorkflow: verified

Ogni operazione TCAF viene risolta tramite Universal Run Protocol. Il runner trasforma un’operazione pubblica o un agent ID in una Run Envelope versionata legata a un solo target.

Percorso di risoluzione

operazione
→ registro
→ manifest dell’agente
→ moduli richiesti e opzionali
→ un solo target
→ un solo adapter
→ Run Envelope
→ gate di review del developer

Istruzioni del framework ed evidenze del target restano etichettate e separate.

Campi dell’envelope

Una Run Envelope contiene:

  • run_protocol_version — versione del protocollo usata dal runner;
  • framework_version — versione del runtime TCAF attivo;
  • operation — operazione pubblica eseguita;
  • agent_id — agente registrato risolto;
  • manifest — percorso del manifest dell’agente;
  • adapter — ID, trasporto, flag di accesso diretto e stato della verifica nativa;
  • target — un solo target vincolato e relativo tipo;
  • input.request — richiesta inline opzionale;
  • input.resource — file, directory, archivio o risorsa host opzionale;
  • instruction_modules — moduli framework e target etichettati con ruolo e origine;
  • unresolved_optional_target_roles — evidenze attese non trovate e prive di fallback;
  • directive — regola finale di esecuzione e obbligo del gate di review.

Moduli di istruzione

Il runner carica, nell’ordine dichiarato:

  1. istruzioni dell’agente;
  2. entrypoint;
  3. schema di output;
  4. moduli core richiesti;
  5. documenti dei ruoli di progetto risolti o fallback dichiarati;
  6. contesto opzionale selezionato esplicitamente;
  7. un solo modulo adapter.

L’host deve usare soltanto la superficie di istruzioni etichettata. I moduli del target sono evidenze, non regole del framework.

Binding del target

Ogni esecuzione lega esattamente un target. L’adapter non può cambiare silenziosamente repository o ampliare il workspace. Quando un ruolo target richiesto non viene risolto, l’envelope lo segnala oppure usa soltanto il fallback dichiarato dal manifest.

Metadati dell’adapter

L’envelope rende visibili le limitazioni del trasporto, compreso se l’invocazione nativa è stata verificata. Un trasporto manuale può mantenere le stesse regole core senza fingere accesso diretto al target o alla scrittura.

Gate di review

La direttiva richiede all’host di fermarsi al gate di review del developer. Generare o trasportare un’envelope non autorizza implementazione, commit o pubblicazione.

Markdown e JSON

L’output Markdown è ottimizzato per il trasporto manuale e conserva i confini dei moduli tramite commenti espliciti. L’output JSON è destinato alle integrazioni e contiene la stessa envelope logica.