Files
agent-radar 2ed3415fb7
Publish Claude Code Binaries / Stage and publish binaries (push) Canceled after 0s
Publish Tutti App Runtime / Build darwin-arm64 (push) Canceled after 0s
Publish Tutti App Runtime / Build darwin-amd64 (push) Canceled after 0s
Publish Tutti App Runtime / Build linux-amd64 (push) Canceled after 0s
Publish Tutti App Runtime / Build windows-amd64 (push) Canceled after 0s
Sync Tutti Agent Skills / sync (push) Canceled after 0s
Windows Agent Adapters / Test Windows agent adapters (push) Canceled after 0s
Windows Daemon Adapters / Test Windows daemon adapters (push) Canceled after 0s
Publish Tutti App Runtime / Publish runtime catalog (push) Canceled after 0s
源码快照 @ 2026-09-01 (source-only, 剔除非源码素材)
2026-09-01 20:17:27 +08:00

251 lines
8.5 KiB
Go

package sessionreplay
import "strings"
type ProviderTapeCodec string
const (
ProviderTapeCodecJSONRPC ProviderTapeCodec = "json-rpc"
ProviderTapeCodecClaudeSidecarV7 ProviderTapeCodec = "claude-sidecar-ndjson-v7"
)
type ProviderRequestMatcher string
const (
ProviderRequestMatcherJSONRPC ProviderRequestMatcher = "json-rpc"
ProviderRequestMatcherClaudeSidecarV7 ProviderRequestMatcher = "claude-sidecar-ndjson-v7"
)
type ProviderInputObserver string
const (
ProviderInputObserverACPJSON ProviderInputObserver = "acp-json-input-units"
ProviderInputObserverClaudeSidecarV7 ProviderInputObserver = "claude-sidecar-ndjson-v7-input-units"
)
type ProviderProjectionCodec string
const (
ProviderProjectionCodecJSONRPCPortable ProviderProjectionCodec = "json-rpc-portable-v1"
ProviderProjectionCodecClaudeSidecarV7Portable ProviderProjectionCodec = "claude-sidecar-ndjson-v7-portable-v1"
)
type ProviderAuditCodec string
const (
ProviderAuditCodecJSONRPCPortable ProviderAuditCodec = "json-rpc-portable-v1"
ProviderAuditCodecClaudeSidecarV7Portable ProviderAuditCodec = "claude-sidecar-ndjson-v7-portable-v1"
)
type ProviderGeneratedRequestField struct {
Method string
Parameter string
ValuePrefix string
PortableValue string
}
type ProviderTapeDescriptor struct {
Codec ProviderTapeCodec
RequestMatcher ProviderRequestMatcher
InputObserver ProviderInputObserver
ProjectionCodec ProviderProjectionCodec
AuditCodec ProviderAuditCodec
SchemaVersion int
ProjectionVersion int
CredentialMethods []string
OptionalProbeMethods []string
AccountReadMethod string
GeneratedRequestFields []ProviderGeneratedRequestField
GeneratedIdentityFields []string
MatchOnlyIdentityFields []string
ExcludeEnvironment bool
}
type ProviderPortableRuntimeDescriptor struct {
HomeEnvVars []string
SessionHomeDirectory string
}
// ProviderReplayDescriptor is the registration point for one Provider's
// recording and replay behavior. Consumers dispatch on the declared codec and
// matcher strategies rather than on Provider identity.
type ProviderReplayDescriptor struct {
ProviderID string
AgentTargetID string
Tape ProviderTapeDescriptor
PortableRuntime ProviderPortableRuntimeDescriptor
}
var providerReplayDescriptors = []ProviderReplayDescriptor{
{
ProviderID: "codex",
AgentTargetID: "local:codex",
Tape: ProviderTapeDescriptor{
Codec: ProviderTapeCodecJSONRPC,
RequestMatcher: ProviderRequestMatcherJSONRPC,
InputObserver: ProviderInputObserverACPJSON,
ProjectionCodec: ProviderProjectionCodecJSONRPCPortable,
AuditCodec: ProviderAuditCodecJSONRPCPortable,
SchemaVersion: ProcessCassetteSchemaVersion,
ProjectionVersion: ProcessCassetteProjectionVersion,
CredentialMethods: []string{"account/login/start", "account/chatgptAuthTokens/refresh"},
OptionalProbeMethods: []string{"thread/read", "thread/goal/get"},
AccountReadMethod: "account/read",
GeneratedRequestFields: []ProviderGeneratedRequestField{{
Method: "turn/start",
Parameter: "clientUserMessageId",
ValuePrefix: "plan-decision:",
PortableValue: "plan-decision:<runtime-operation>",
}},
GeneratedIdentityFields: []string{
"clientUserMessageId",
},
},
PortableRuntime: ProviderPortableRuntimeDescriptor{
HomeEnvVars: []string{"CODEX_HOME"},
SessionHomeDirectory: "codex-home",
},
},
{
ProviderID: "claude-code",
AgentTargetID: "local:claude-code",
Tape: ProviderTapeDescriptor{
Codec: ProviderTapeCodecClaudeSidecarV7,
RequestMatcher: ProviderRequestMatcherClaudeSidecarV7,
InputObserver: ProviderInputObserverClaudeSidecarV7,
ProjectionCodec: ProviderProjectionCodecClaudeSidecarV7Portable,
AuditCodec: ProviderAuditCodecClaudeSidecarV7Portable,
SchemaVersion: ProcessCassetteSchemaVersion,
ProjectionVersion: ProcessCassetteProjectionVersion,
GeneratedIdentityFields: []string{
"agentSessionId",
"providerTurnId",
"turnId",
"promptCorrelationId",
"goalOperationId",
// Inbound goal_command_started / turn identity use these
// aliases of the outbound goalOperationId. Remap them so
// GoalControlApplied can complete the live pending operation.
"operationId",
"sourceGoalOperationId",
},
// The adapter creates this identity before replay starts, but the
// recorded session_started response remains the Provider-owned value
// used by the semantic cassette state.
MatchOnlyIdentityFields: []string{"providerSessionId"},
ExcludeEnvironment: true,
},
PortableRuntime: ProviderPortableRuntimeDescriptor{
HomeEnvVars: []string{"CLAUDE_CONFIG_DIR"},
SessionHomeDirectory: "claude-home",
},
},
}
func FindProviderReplayByTarget(agentTargetID string) (ProviderReplayDescriptor, bool) {
want := normalizeProviderReplayIdentity(agentTargetID)
for _, descriptor := range providerReplayDescriptors {
if normalizeProviderReplayIdentity(descriptor.AgentTargetID) == want {
return cloneProviderReplayDescriptor(descriptor), true
}
}
return ProviderReplayDescriptor{}, false
}
func FindProviderReplayByProvider(providerID string) (ProviderReplayDescriptor, bool) {
want := normalizeProviderReplayIdentity(providerID)
for _, descriptor := range providerReplayDescriptors {
if normalizeProviderReplayIdentity(descriptor.ProviderID) == want {
return cloneProviderReplayDescriptor(descriptor), true
}
}
return ProviderReplayDescriptor{}, false
}
// ResolveProviderReplay resolves one canonical Session binding. When both
// identities are present they must name the same registered adapter.
func ResolveProviderReplay(
agentTargetID string,
providerID string,
) (ProviderReplayDescriptor, bool) {
targetID := normalizeProviderReplayIdentity(agentTargetID)
providerID = normalizeProviderReplayIdentity(providerID)
if targetID == "" {
return FindProviderReplayByProvider(providerID)
}
if providerID == "" {
return FindProviderReplayByTarget(targetID)
}
byTarget, targetFound := FindProviderReplayByTarget(targetID)
byProvider, providerFound := FindProviderReplayByProvider(providerID)
if !targetFound || !providerFound ||
normalizeProviderReplayIdentity(byTarget.ProviderID) !=
normalizeProviderReplayIdentity(byProvider.ProviderID) {
return ProviderReplayDescriptor{}, false
}
return byTarget, true
}
func (d ProviderReplayDescriptor) SupportsFormat(schemaVersion, projectionVersion int) bool {
return d.Tape.SchemaVersion == schemaVersion &&
d.Tape.ProjectionVersion == projectionVersion
}
func (d ProviderReplayDescriptor) MethodCarriesCredentials(method string) bool {
return containsProviderReplayValue(d.Tape.CredentialMethods, method)
}
func (d ProviderReplayDescriptor) IsOptionalProbeMethod(method string) bool {
return containsProviderReplayValue(d.Tape.OptionalProbeMethods, method)
}
func (d ProviderReplayDescriptor) IsHomeEnvVar(name string) bool {
return containsProviderReplayValue(d.PortableRuntime.HomeEnvVars, name)
}
func (d ProviderReplayDescriptor) IsGeneratedIdentityField(name string) bool {
return containsProviderReplayValue(d.Tape.GeneratedIdentityFields, name)
}
func (d ProviderReplayDescriptor) IsMatchedIdentityField(name string) bool {
return d.IsGeneratedIdentityField(name) ||
containsProviderReplayValue(d.Tape.MatchOnlyIdentityFields, name)
}
func containsProviderReplayValue(values []string, value string) bool {
want := normalizeProviderReplayIdentity(value)
for _, candidate := range values {
if normalizeProviderReplayIdentity(candidate) == want {
return true
}
}
return false
}
func normalizeProviderReplayIdentity(value string) string {
return strings.ToLower(strings.TrimSpace(value))
}
func cloneProviderReplayDescriptor(source ProviderReplayDescriptor) ProviderReplayDescriptor {
cloned := source
cloned.Tape.CredentialMethods = append([]string(nil), source.Tape.CredentialMethods...)
cloned.Tape.OptionalProbeMethods = append([]string(nil), source.Tape.OptionalProbeMethods...)
cloned.Tape.GeneratedRequestFields = append(
[]ProviderGeneratedRequestField(nil),
source.Tape.GeneratedRequestFields...,
)
cloned.Tape.GeneratedIdentityFields = append(
[]string(nil),
source.Tape.GeneratedIdentityFields...,
)
cloned.Tape.MatchOnlyIdentityFields = append(
[]string(nil),
source.Tape.MatchOnlyIdentityFields...,
)
cloned.PortableRuntime.HomeEnvVars = append(
[]string(nil),
source.PortableRuntime.HomeEnvVars...,
)
return cloned
}