Seleziona un adapter

Un adapter definisce come una Run Envelope TCAF raggiunge un host AI e quale accesso diretto al target quell’host può fornire.

Non definisce il task, non amplia i permessi e non sostituisce il Task Contract. Lo stesso modello di autorizzazione controllato dal developer si applica a ogni adapter.

Ordine di selezione

Quando la selezione è automatica, TCAF valuta le fonti in questo ordine:

1. adapter ID fornito dall’integrazione host;
2. variabile d’ambiente TCAF_ADAPTER;
3. rilevamento dell’ambiente;
4. adapter predefinito del registro.

L’adapter predefinito corrente è generic-cli.

Puoi registrare una preferenza durante l’installazione:

python install.py --adapter codex

Puoi anche applicare un override a una singola operazione:

tcaf task --target <percorso-progetto> --request <richiesta-delimitata> --adapter cline

Usa un override esplicito durante i test o quando il rilevamento automatico non rappresenta l’host reale. Non usarlo per dichiarare capacità che l’host non possiede.

Codex

Adapter ID:

codex

Trasporto corrente:

native

Stato:

verified

L’adapter Codex supporta accesso diretto al target e modifica diretta entro i permessi e la superficie dichiarati dall’esecuzione.

Usalo quando l’integrazione Codex installata globalmente può associare il progetto attivo come unico target e ricevere nativamente l’Universal Run Protocol.

Le operazioni pubbliche restano:

tcaf bootstrap
tcaf adopt
tcaf task
tcaf run

Un’integrazione nativa non autorizza Codex a ignorare il review gate, modificare file non pertinenti o eseguire automaticamente operazioni Git.

Cline

Adapter ID:

cline

Trasporto corrente:

manual-envelope

Stato:

verified-with-limitations

La procedura delimitata per Cline è verificata, ma l’invocazione nativa runner-to-Cline non è ancora verificata.

Procedura corrente:

1. esegui l’operazione tcaf pertinente fuori da Cline con --adapter cline;
2. avvia un nuovo task Cline;
3. incolla la Run Envelope generata senza modificarla;
4. aggiungi esattamente un marker di trasporto:

TCAF CLINE STEP: INSPECT
TCAF CLINE STEP: WRITE <percorso-relativo-al-repository>
TCAF CLINE STEP: VALIDATE

INSPECT e VALIDATE sono read-only. WRITE autorizza al massimo una operazione di scrittura sul file indicato e una conferma di scrittura nel task Cline corrente.

Il marker può restringere l’envelope. Non può ampliare target, perimetro, permessi o output.

Usa un nuovo task Cline per ogni scrittura e revisiona il file reale prima di continuare. I comandi da terminale non vengono usati per impostazione predefinita; l’agente dovrebbe riportare da uno a tre comandi DEVELOPER_RUN o controlli manuali.

Generic CLI

Adapter ID:

generic-cli

Trasporto corrente:

stdout

Stato:

framework-aligned

Questo adapter stampa la Run Envelope per un host da riga di comando o per un’altra integrazione in grado di consumare lo standard output.

Il registro dichiara accesso diretto al target ma non accesso diretto alla modifica. Lo strumento ricevente non deve fingere che il solo trasporto dell’output conceda capacità di scrittura sui file.

Usa questo adapter quando:

• l’host può associare il target in modo affidabile;
• l’envelope può essere trasferita senza modifiche;
• implementazione o controlli possono essere eseguiti tramite un meccanismo separatamente controllato;
• il developer può revisionare ogni passaggio sostanziale.

Generic chat

Adapter ID:

generic-chat

Trasporto corrente:

host-resource

Stato:

framework-aligned

Il registro non presume accesso diretto al target o alla modifica.

La chat generica è appropriata soltanto quando l’host può fornire accesso persistente alle istruzioni del framework necessarie e associare le evidenze esatte del target per la sessione. Una normale conversazione che dipende soltanto dalla memoria della chat non è sufficiente per un’esecuzione TCAF affidabile.

Usa la chat generica soprattutto per:

• analisi basate su evidenze fornite esplicitamente;
• preparazione di un Task Contract da eseguire successivamente;
• review di una envelope o di un risultato;
• produzione di comandi e procedure per il developer.

Non dichiarare ispezione diretta del repository o modifica dei file quando l’host non ha fornito tali risorse.

L’adapter non decide l’autorità del modello

Ogni adapter deve preservare:

• esattamente un target;
• superficie di modifica consentita;
• review gate del developer;
• comportamento preservation-first;
• report esplicito di esito ed evidenze;
• separazione dell’implementazione da commit, push e altre operazioni Git.

Un host più capace può eseguire direttamente una parte maggiore del lavoro autorizzato. Non riceve un confine di autorizzazione più ampio.

Verifica la selezione attiva

Esegui:

tcaf doctor

L’output riporta l’adapter scelto dalla risoluzione automatica.

Per l’output leggibile da altri strumenti:

tcaf doctor --format json

Cambia adapter deliberatamente

Cambiare adapter è corretto quando cambia l’host di esecuzione reale. Non deve essere un modo per ignorare una limitazione fingendo che non esista.

Esempi:

• passare dalla manual-envelope di Cline all’invocazione nativa Codex cambia il trasporto, non il Task Contract;
• passare da un host con modifica diretta alla chat generica richiede che il workflow restituisca procedure invece di dichiarare modifiche;
• un futuro bridge nativo per Cline deve restare planned o non verificato finché non supera test di accettazione dedicati.

Leggi le pagine dedicate a Codex e Cline prima di dipendere da comportamenti specifici dell’adapter.