Skip to content

armgit / ax

Public Imported from GitHub
0

Agent Executor (AX) is Google's open agentic orchestration runtime

Go

feat(ax): Implement Conversation Forking and Fix Trace Viewer Ordering (#229)

anj-sd736972e54f2
diff --git a/cmd/ax/fork.go b/cmd/ax/fork.go
index f0ba4cb..99962ab 100644
--- a/cmd/ax/fork.go
+++ b/cmd/ax/fork.go
@@ -15,14 +15,19 @@
package main
import (
+ "fmt"
+
+ "github.com/google/ax/internal/config"
+ "github.com/google/ax/proto"
"github.com/spf13/cobra"
)
var (
forkSourceConversation string
- forkSourceSeq int32
+ forkSourceSeq int32
forkDestConversation string
forkServerAddr string
+ forkConfigFile string
)
var forkCmd = &cobra.Command{
@@ -37,11 +42,55 @@ func init() {
forkCmd.Flags().StringVar(&forkSourceConversation, "src-conversation", "", "Source conversation ID to fork from (required)")
forkCmd.Flags().Int32Var(&forkSourceSeq, "src-seq", 0, "Sequence number to fork from (optional, defaults to latest)")
forkCmd.Flags().StringVar(&forkDestConversation, "dest-conversation", "", "Destination conversation ID (optional, generates UUID if not provided)")
- forkCmd.Flags().StringVar(&forkServerAddr, "server", "localhost:8494", "gRPC controller server address (default: localhost:8494)")
+ forkCmd.Flags().StringVar(&forkServerAddr, "server", "", "gRPC controller server address (if specified, connects to remote server; otherwise runs with a local built-in AX server)")
+ forkCmd.Flags().StringVar(&forkConfigFile, "config", "ax.yaml", "Path to YAML configuration file (only used with a local built-in AX server)")
forkCmd.MarkFlagRequired("src-conversation")
}
func runFork(cmd *cobra.Command, args []string) error {
- panic("forking not implemented")
+ ctx := cmd.Context()
+
+ if forkServerAddr == "" {
+ // Headless mode
+ cfg, err := config.LoadFromFile(forkConfigFile)
+ if err != nil {
+ return fmt.Errorf("error loading config file '%s': %w", forkConfigFile, err)
+ }
+
+ c, err := newControllerFromConfig(ctx, cfg)
+ if err != nil {
+ return fmt.Errorf("error creating controller: %w", err)
+ }
+ defer c.Close()
+
+ destID, err := c.Fork(ctx, forkSourceConversation, forkSourceSeq, forkDestConversation)
+ if err != nil {
+ return fmt.Errorf("error forking conversation: %w", err)
+ }
+
+ fmt.Printf("Conversation forked successfully. New conversation ID: %s\n", destID)
+ return nil
+ }
+
+ // Remote mode
+ conn, err := connect(forkServerAddr)
+ if err != nil {
+ return err
+ }
+ defer conn.Close()
+
+ client := proto.NewEventLogServiceClient(conn)
+
+ resp, err := client.Fork(ctx, &proto.ForkRequest{
+ SrcConversationId: forkSourceConversation,
+ SrcSeq: forkSourceSeq,
+ DestConversationId: forkDestConversation,
+ })
+ if err != nil {
+ return fmt.Errorf("error forking conversation: %w", err)
+ }
+
+ fmt.Printf("Conversation forked successfully. New conversation ID: %s\n", resp.ConversationId)
+ return nil
}
diff --git a/cmd/ax/main.go b/cmd/ax/main.go
index c574332..e35e583 100644
--- a/cmd/ax/main.go
+++ b/cmd/ax/main.go
@@ -49,7 +49,7 @@ func init() {
rootCmd.AddCommand(serveCmd)
rootCmd.AddCommand(eventlogCmd)
- eventlogCmd.AddCommand(forkCmd)
+ rootCmd.AddCommand(forkCmd)
eventlogCmd.AddCommand(traceCmd)
}
diff --git a/cmd/ax/trace.go b/cmd/ax/trace.go
index 8725747..d067e2d 100644
--- a/cmd/ax/trace.go
+++ b/cmd/ax/trace.go
@@ -113,34 +113,36 @@ type ExecTrace struct {
}
type TraceData struct {
- RootExecID string `json:"root_exec_id"`
- Execs []ExecTrace `json:"execs"`
+ ConversationID string `json:"conversation_id"`
+ RootExecID string `json:"root_exec_id"`
+ Execs []ExecTrace `json:"execs"`
}
func loadTraceData(ctx context.Context, cfg *config.Config, convID string) (*TraceData, error) {
- events, rootExecID, err := fetchEventsByConversation(ctx, cfg, convID)
+ events, rootExecID, execIDs, err := fetchEventsByConversation(ctx, cfg, convID)
if err != nil {
return nil, err
}
data := &TraceData{
- RootExecID: rootExecID,
- Execs: buildExecTraces(rootExecID, events),
+ ConversationID: convID,
+ RootExecID: rootExecID,
+ Execs: buildExecTraces(rootExecID, execIDs, events),
}
return data, nil
}
-func fetchEventsByConversation(ctx context.Context, cfg *config.Config, convID string) ([]*proto.ExecutionEvent, string, error) {
+func fetchEventsByConversation(ctx context.Context, cfg *config.Config, convID string) ([]*proto.ExecutionEvent, string, []string, error) {
evLog, err := executor.OpenSQLiteEventLog(cfg.EventLog.SQLiteConfig.Filename)
if err != nil {
- return nil, "", fmt.Errorf("could not open sqlite eventlog: %w", err)
+ return nil, "", nil, fmt.Errorf("could not open sqlite eventlog: %w", err)
}
defer evLog.Close()
convEvents, err := evLog.Events(ctx, convID)
if err != nil {
- return nil, "", fmt.Errorf("failed to query conversation events: %w", err)
+ return nil, "", nil, fmt.Errorf("failed to query conversation events: %w", err)
}
var execIDs []string
@@ -153,14 +155,14 @@ func fetchEventsByConversation(ctx context.Context, cfg *config.Config, convID s
}
if len(execIDs) == 0 {
- return nil, "", fmt.Errorf("no executions found for conversation: %s", convID)
+ return nil, "", nil, fmt.Errorf("no executions found for conversation: %s", convID)
}
var allEvents []*proto.ExecutionEvent
for _, eID := range execIDs {
events, err := evLog.ExecEvents(ctx, eID)
if err != nil {
- return nil, "", fmt.Errorf("failed to query events for exec %s: %w", eID, err)
+ return nil, "", nil, fmt.Errorf("failed to query events for exec %s: %w", eID, err)
}
allEvents = append(allEvents, events...)
}
@@ -168,10 +170,10 @@ func fetchEventsByConversation(ctx context.Context, cfg *config.Config, convID s
// Use the first execID as the rootExecID as requested by user
rootExecID := execIDs[0]
- return allEvents, rootExecID, nil
+ return allEvents, rootExecID, execIDs, nil
}
-func buildExecTraces(rootExecID string, events []*proto.ExecutionEvent) []ExecTrace {
+func buildExecTraces(rootExecID string, execIDs []string, events []*proto.ExecutionEvent) []ExecTrace {
execsMap := make(map[string][]ExecutionEvent)
for _, protoEv := range events {
@@ -196,15 +198,18 @@ func buildExecTraces(rootExecID string, events []*proto.ExecutionEvent) []ExecTr
})
}
- // Root exec first, then sub-execs sorted by name.
- sort.Slice(execs, func(i, j int) bool {
- if execs[i].ExecID == rootExecID {
- return true
- }
- if execs[j].ExecID == rootExecID {
- return false
+ // Sort execs by the order they appeared in execIDs (chronological)
+ getIndex := func(execID string) int {
+ for idx, id := range execIDs {
+ if id == execID {
+ return idx
+ }
}
- return execs[i].ExecID < execs[j].ExecID
+ return len(execIDs)
+ }
+
+ sort.Slice(execs, func(i, j int) bool {
+ return getIndex(execs[i].ExecID) < getIndex(execs[j].ExecID)
})
return execs
@@ -277,7 +282,7 @@ func serveTraceUI(listener net.Listener, data *TraceData, rawHTML string) error
}
url := fmt.Sprintf("http://%s", addr)
- fmt.Printf("Starting trace viewer for %s...\n", data.RootExecID)
+ fmt.Printf("Starting trace viewer for conversation %s...\n", data.ConversationID)
fmt.Printf("Opening browser to %s\n", url)
fmt.Printf("Press Ctrl+C to exit.\n")
@@ -505,7 +510,7 @@ function renderTrace(data){
});
const span=maxT-minT||1;
- let html='<div class="trace-hdr"><div class="label">Trace</div><div class="exec-id">'+esc(data.root_exec_id)+'</div></div>';
+ let html='<div class="trace-hdr"><div class="label">Conversation</div><div class="exec-id">'+esc(data.conversation_id)+'</div></div>';
html+='<div class="timeline-card"><div class="card-title">Timeline</div><div class="tl-rows">';
execTimes.forEach(({execID,start,end},i)=>{
diff --git a/internal/controller/controller.go b/internal/controller/controller.go
index c5207b5..b82a238 100644
--- a/internal/controller/controller.go
+++ b/internal/controller/controller.go
@@ -262,6 +262,51 @@ func (d *Controller) Delete(ctx context.Context, conversationID string) error {
return d.eventLog.DeleteEvents(ctx, conversationID)
}
+// Fork forks an event log from a specific conversation up to a checkpoint.
+func (d *Controller) Fork(ctx context.Context, srcConversationID string, srcSeq int32, destConversationID string) (string, error) {
+ if srcConversationID == "" {
+ return "", fmt.Errorf("src_conversation_id is required")
+ }
+ // TODO(anj-s): Check whether destination ID already exists and reject collisions.
+ if destConversationID == "" {
+ destConversationID = uuid.NewString()
+ }
+
+ inFlight, cleanup := d.markInFlight(destConversationID)
+ defer cleanup()
+
+ if inFlight {
+ return "", fmt.Errorf("conversation %q is already in flight", destConversationID)
+ }
+
+ events, err := d.eventLog.Events(ctx, srcConversationID)
+ if err != nil {
+ return "", fmt.Errorf("failed to retrieve source events: %w", err)
+ }
+ if len(events) == 0 {
+ return "", fmt.Errorf("source conversation %s not found or has no events", srcConversationID)
+ }
+
+ for _, ev := range events {
+ if srcSeq > 0 && ev.Seq > srcSeq {
+ break // Optimization: events are ordered by seq, so we can stop iterating
+ }
+ // Clone the event to update the conversation ID
+ newEvent := &proto.ConversationEvent{
+ ConversationId: destConversationID,
+ Seq: ev.Seq,
+ ExecId: ev.ExecId,
+ Messages: ev.Messages,
+ State: ev.State,
+ }
+ if _, err := d.eventLog.Append(ctx, newEvent); err != nil {
+ return "", fmt.Errorf("failed to append forked event: %w", err)
+ }
+ }
+
+ return destConversationID, nil
+}
+
// Registry returns the agent registry.
func (d *Controller) Registry() *Registry {
return d.registry
diff --git a/internal/controller/executor/executortest/eventlog.go b/internal/controller/executor/executortest/eventlog.go
index 972283f..39f208e 100644
--- a/internal/controller/executor/executortest/eventlog.go
+++ b/internal/controller/executor/executortest/eventlog.go
@@ -33,8 +33,17 @@ func (m *MemoryEventLog) Append(_ context.Context, event *proto.ConversationEven
m.mu.Lock()
defer m.mu.Unlock()
- seq := int32(len(m.AllEvents) + 1)
- event.Seq = seq
+ seq := event.Seq
+ if seq == 0 {
+ maxSeq := int32(0)
+ for _, ev := range m.AllEvents {
+ if ev.ConversationId == event.ConversationId && ev.Seq > maxSeq {
+ maxSeq = ev.Seq
+ }
+ }
+ seq = maxSeq + 1
+ event.Seq = seq
+ }
m.AllEvents = append(m.AllEvents, event)
return seq, nil
}
diff --git a/internal/controller/fork_test.go b/internal/controller/fork_test.go
new file mode 100644
index 0000000..9b1b503
--- /dev/null
+++ b/internal/controller/fork_test.go
@@ -0,0 +1,106 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package controller
+
+import (
+ "context"
+ "testing"
+
+ "github.com/google/ax/internal/agent"
+ "github.com/google/ax/internal/controller/executor"
+ "github.com/google/ax/internal/controller/executor/executortest"
+ "github.com/google/ax/proto"
+)
+
+func TestController_Fork(t *testing.T) {
+ ctx := context.Background()
+ srcCID := "src-conv"
+ destCID := "dest-conv"
+
+ log := &executortest.MemoryEventLog{}
+ // Pre-populate history
+ log.AllEvents = []*proto.ConversationEvent{
+ {
+ ConversationId: srcCID,
+ Seq: 1,
+ Messages: []*proto.Message{
+ {Role: "user", Content: &proto.Content{Type: &proto.Content_Text{Text: &proto.TextContent{Text: "msg 1"}}}},
+ },
+ State: proto.State_STATE_COMPLETED,
+ },
+ {
+ ConversationId: srcCID,
+ Seq: 2,
+ Messages: []*proto.Message{
+ {Role: "assistant", Content: &proto.Content{Type: &proto.Content_Text{Text: &proto.TextContent{Text: "msg 2"}}}},
+ },
+ State: proto.State_STATE_COMPLETED,
+ },
+ }
+
+ c, err := New(ctx, Config{
+ EventLogBuilder: func() (executor.EventLog, error) {
+ return log, nil
+ },
+ PlannerBuilder: func(ctx context.Context, r *Registry) (agent.Agent, error) {
+ return &dummyAgent{}, nil
+ },
+ })
+ if err != nil {
+ t.Fatal(err)
+ }
+ defer c.Close()
+
+ // Case 1: Fork without seq (should copy all)
+ forkedID, err := c.Fork(ctx, srcCID, 0, destCID)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if forkedID != destCID {
+ t.Fatalf("expected destCID %s, got %s", destCID, forkedID)
+ }
+
+ events, err := log.Events(ctx, destCID)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if len(events) != 2 {
+ t.Fatalf("expected 2 events, got %d", len(events))
+ }
+ if events[0].Seq != 1 || events[1].Seq != 2 {
+ t.Errorf("sequences mismatch")
+ }
+
+ // Case 2: Fork with seq 1
+ destCID2 := "dest-conv-2"
+ forkedID2, err := c.Fork(ctx, srcCID, 1, destCID2)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if forkedID2 != destCID2 {
+ t.Fatalf("expected destCID2 %s, got %s", destCID2, forkedID2)
+ }
+
+ events2, err := log.Events(ctx, destCID2)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if len(events2) != 1 {
+ t.Fatalf("expected 1 event, got %d", len(events2))
+ }
+ if events2[0].Seq != 1 {
+ t.Errorf("expected seq 1, got %d", events2[0].Seq)
+ }
+}
diff --git a/internal/server/server.go b/internal/server/server.go
index 5cb4b68..1faaf5f 100644
--- a/internal/server/server.go
+++ b/internal/server/server.go
@@ -57,7 +57,14 @@ func (s *Server) Exec(req *proto.ExecRequest, stream grpc.ServerStreamingServer[
}
func (s *Server) Fork(ctx context.Context, req *proto.ForkRequest) (*proto.ForkResponse, error) {
- return nil, status.Errorf(codes.Unimplemented, "not implemented")
+ if req.SrcConversationId == "" {
+ return nil, status.Errorf(codes.InvalidArgument, "src_conversation_id is required")
+ }
+ destID, err := s.controller.Fork(ctx, req.SrcConversationId, req.SrcSeq, req.DestConversationId)
+ if err != nil {
+ return nil, status.Errorf(codes.Internal, "failed to fork conversation: %v", err)
+ }
+ return &proto.ForkResponse{ConversationId: destID}, nil
}
func (s *Server) List(ctx context.Context, req *proto.ListRequest) (*proto.ListResponse, error) {
diff --git a/internal/server/server_test.go b/internal/server/server_test.go
new file mode 100644
index 0000000..10afcf2
--- /dev/null
+++ b/internal/server/server_test.go
@@ -0,0 +1,87 @@
+// Copyright 2026 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package server
+
+import (
+ "context"
+ "testing"
+
+ "github.com/google/ax/internal/agent"
+ "github.com/google/ax/internal/controller"
+ "github.com/google/ax/internal/controller/executor"
+ "github.com/google/ax/internal/controller/executor/executortest"
+ "github.com/google/ax/proto"
+)
+
+type dummyAgent struct{}
+
+func (a *dummyAgent) Connect(ctx context.Context, execID string, start *proto.AgentStart, e agent.Executor, o agent.OutputHandler) error {
+ return nil
+}
+func (a *dummyAgent) HealthCheck(ctx context.Context) error { return nil }
+func (a *dummyAgent) Close() error { return nil }
+
+func TestServer_Fork(t *testing.T) {
+ ctx := context.Background()
+ srcCID := "src-conv"
+ destCID := "dest-conv"
+
+ log := &executortest.MemoryEventLog{}
+ log.AllEvents = []*proto.ConversationEvent{
+ {
+ ConversationId: srcCID,
+ Seq: 1,
+ Messages: []*proto.Message{
+ {Role: "user", Content: &proto.Content{Type: &proto.Content_Text{Text: &proto.TextContent{Text: "msg 1"}}}},
+ },
+ State: proto.State_STATE_COMPLETED,
+ },
+ }
+
+ c, err := controller.New(ctx, controller.Config{
+ EventLogBuilder: func() (executor.EventLog, error) {
+ return log, nil
+ },
+ PlannerBuilder: func(ctx context.Context, r *controller.Registry) (agent.Agent, error) {
+ return &dummyAgent{}, nil
+ },
+ })
+ if err != nil {
+ t.Fatal(err)
+ }
+ defer c.Close()
+
+ s := New(c)
+
+ resp, err := s.Fork(ctx, &proto.ForkRequest{
+ SrcConversationId: srcCID,
+ DestConversationId: destCID,
+ })
+ if err != nil {
+ t.Fatal(err)
+ }
+
+ if resp.ConversationId != destCID {
+ t.Fatalf("expected destCID %s, got %s", destCID, resp.ConversationId)
+ }
+
+ events, err := log.Events(ctx, destCID)
+ if err != nil {
+ t.Fatal(err)
+ }
+ if len(events) != 1 {
+ t.Fatalf("expected 1 event, got %d", len(events))
+ }
+}
diff --git a/internal/testagent/proto/testagent.pb.go b/internal/testagent/proto/testagent.pb.go
index 0dbd921..fe12058 100644
--- a/internal/testagent/proto/testagent.pb.go
+++ b/internal/testagent/proto/testagent.pb.go
@@ -15,7 +15,7 @@
// Code generated by protoc-gen-go. DO NOT EDIT.
// versions:
// protoc-gen-go v1.36.11
-// protoc v7.34.1
+// protoc v5.26.1
// source: internal/testagent/proto/testagent.proto
package proto
diff --git a/proto/ax.pb.go b/proto/ax.pb.go
index 830ee37..47390ce 100644
--- a/proto/ax.pb.go
+++ b/proto/ax.pb.go
@@ -15,7 +15,7 @@
// Code generated by protoc-gen-go. DO NOT EDIT.
// versions:
// protoc-gen-go v1.36.11
-// protoc v7.34.1
+// protoc v5.26.1
// source: proto/ax.proto
package proto
@@ -1144,9 +1144,17 @@ func (*DeleteResponse) Descriptor() ([]byte, []int) {
}
type ForkRequest struct {
- state protoimpl.MessageState `protogen:"open.v1"`
- unknownFields protoimpl.UnknownFields
- sizeCache protoimpl.SizeCache
+ state protoimpl.MessageState `protogen:"open.v1"`
+ // Required: The source conversation ID to fork from.
+ SrcConversationId string `protobuf:"bytes,1,opt,name=src_conversation_id,json=srcConversationId,proto3" json:"src_conversation_id,omitempty"`
+ // Optional: The sequence number to fork from.
+ // Defaults to the latest sequence if not set or set to 0.
+ SrcSeq int32 `protobuf:"varint,2,opt,name=src_seq,json=srcSeq,proto3" json:"src_seq,omitempty"`
+ // Optional: The destination conversation ID.
+ // Generates a new UUID if not provided.
+ DestConversationId string `protobuf:"bytes,3,opt,name=dest_conversation_id,json=destConversationId,proto3" json:"dest_conversation_id,omitempty"`
+ unknownFields protoimpl.UnknownFields
+ sizeCache protoimpl.SizeCache
}
func (x *ForkRequest) Reset() {
@@ -1179,10 +1187,32 @@ func (*ForkRequest) Descriptor() ([]byte, []int) {
return file_proto_ax_proto_rawDescGZIP(), []int{18}
}
+func (x *ForkRequest) GetSrcConversationId() string {
+ if x != nil {
+ return x.SrcConversationId
+ }
+ return ""
+}
+
+func (x *ForkRequest) GetSrcSeq() int32 {
+ if x != nil {
+ return x.SrcSeq
+ }
+ return 0
+}
+
+func (x *ForkRequest) GetDestConversationId() string {
+ if x != nil {
+ return x.DestConversationId
+ }
+ return ""
+}
+
type ForkResponse struct {
- state protoimpl.MessageState `protogen:"open.v1"`
- unknownFields protoimpl.UnknownFields
- sizeCache protoimpl.SizeCache
+ state protoimpl.MessageState `protogen:"open.v1"`
+ ConversationId string `protobuf:"bytes,1,opt,name=conversation_id,json=conversationId,proto3" json:"conversation_id,omitempty"` // The ID of the new conversation
+ unknownFields protoimpl.UnknownFields
+ sizeCache protoimpl.SizeCache
}
func (x *ForkResponse) Reset() {
@@ -1215,6 +1245,13 @@ func (*ForkResponse) Descriptor() ([]byte, []int) {
return file_proto_ax_proto_rawDescGZIP(), []int{19}
}
+func (x *ForkResponse) GetConversationId() string {
+ if x != nil {
+ return x.ConversationId
+ }
+ return ""
+}
+
// GeminiConfig is the configuration for a Gemini agent.
type GeminiConfig struct {
state protoimpl.MessageState `protogen:"open.v1"`
@@ -1362,9 +1399,13 @@ const file_proto_ax_proto_rawDesc = "" +
"\x06events\x18\x01 \x03(\v2\x15.ax.ConversationEventR\x06events\"8\n" +
"\rDeleteRequest\x12'\n" +
"\x0fconversation_id\x18\x01 \x01(\tR\x0econversationId\"\x10\n" +
- "\x0eDeleteResponse\"\r\n" +
- "\vForkRequest\"\x0e\n" +
- "\fForkResponse\"\xb3\x01\n" +
+ "\x0eDeleteResponse\"\x88\x01\n" +
+ "\vForkRequest\x12.\n" +
+ "\x13src_conversation_id\x18\x01 \x01(\tR\x11srcConversationId\x12\x17\n" +
+ "\asrc_seq\x18\x02 \x01(\x05R\x06srcSeq\x120\n" +
+ "\x14dest_conversation_id\x18\x03 \x01(\tR\x12destConversationId\"7\n" +
+ "\fForkResponse\x12'\n" +
+ "\x0fconversation_id\x18\x01 \x01(\tR\x0econversationId\"\xb3\x01\n" +
"\fGeminiConfig\x12\x14\n" +
"\x05model\x18\x01 \x01(\tR\x05model\x12#\n" +
"\rsystem_prompt\x18\x02 \x01(\tR\fsystemPrompt\x12\x1d\n" +
diff --git a/proto/ax.proto b/proto/ax.proto
index 1785307..d29d40e 100644
--- a/proto/ax.proto
+++ b/proto/ax.proto
@@ -166,9 +166,20 @@ message DeleteRequest {
message DeleteResponse {}
-message ForkRequest {}
+message ForkRequest {
+ // Required: The source conversation ID to fork from.
+ string src_conversation_id = 1;
+ // Optional: The sequence number to fork from.
+ // Defaults to the latest sequence if not set or set to 0.
+ int32 src_seq = 2;
+ // Optional: The destination conversation ID.
+ // Generates a new UUID if not provided.
+ string dest_conversation_id = 3;
+}
-message ForkResponse {}
+message ForkResponse {
+ string conversation_id = 1; // The ID of the new conversation
+}
service EventLogService {
// List conversational events.
diff --git a/proto/ax_grpc.pb.go b/proto/ax_grpc.pb.go
index 2318330..6c5aa3b 100644
--- a/proto/ax_grpc.pb.go
+++ b/proto/ax_grpc.pb.go
@@ -14,8 +14,8 @@
// Code generated by protoc-gen-go-grpc. DO NOT EDIT.
// versions:
-// - protoc-gen-go-grpc v1.6.0
-// - protoc v7.34.1
+// - protoc-gen-go-grpc v1.6.1
+// - protoc v5.26.1
// source: proto/ax.proto
package proto
diff --git a/proto/content.pb.go b/proto/content.pb.go
index a990246..0c840f1 100644
--- a/proto/content.pb.go
+++ b/proto/content.pb.go
@@ -15,7 +15,7 @@
// Code generated by protoc-gen-go. DO NOT EDIT.
// versions:
// protoc-gen-go v1.36.11
-// protoc v7.34.1
+// protoc v5.26.1
// source: proto/content.proto
package proto