runtimev1

package
v0.3.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 18, 2026 License: MIT Imports: 10 Imported by: 0

Documentation

Index

Constants

View Source
const (
	TaskStoreService_CreateTask_FullMethodName = "/kagent.runtime.v1.TaskStoreService/CreateTask"
	TaskStoreService_GetTask_FullMethodName    = "/kagent.runtime.v1.TaskStoreService/GetTask"
	TaskStoreService_UpdateTask_FullMethodName = "/kagent.runtime.v1.TaskStoreService/UpdateTask"
	TaskStoreService_ListTasks_FullMethodName  = "/kagent.runtime.v1.TaskStoreService/ListTasks"
	TaskStoreService_SettleTask_FullMethodName = "/kagent.runtime.v1.TaskStoreService/SettleTask"
)

Variables

View Source
var File_kagent_runtime_v1_task_store_proto protoreflect.FileDescriptor
View Source
var TaskStoreService_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "kagent.runtime.v1.TaskStoreService",
	HandlerType: (*TaskStoreServiceServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "CreateTask",
			Handler:    _TaskStoreService_CreateTask_Handler,
		},
		{
			MethodName: "GetTask",
			Handler:    _TaskStoreService_GetTask_Handler,
		},
		{
			MethodName: "UpdateTask",
			Handler:    _TaskStoreService_UpdateTask_Handler,
		},
		{
			MethodName: "ListTasks",
			Handler:    _TaskStoreService_ListTasks_Handler,
		},
		{
			MethodName: "SettleTask",
			Handler:    _TaskStoreService_SettleTask_Handler,
		},
	},
	Streams:  []grpc.StreamDesc{},
	Metadata: "kagent/runtime/v1/task_store.proto",
}

TaskStoreService_ServiceDesc is the grpc.ServiceDesc for TaskStoreService service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)

Functions

func RegisterTaskStoreServiceServer

func RegisterTaskStoreServiceServer(s grpc.ServiceRegistrar, srv TaskStoreServiceServer)

Types

type StoredTask

type StoredTask struct {
	Task *v1.Task `protobuf:"bytes,1,opt,name=task,proto3" json:"task,omitempty"`
	// Opaque task storage version, scoped to its session. Reload after restoring
	// a fork, which receives new public context and task IDs.
	Version int64 `protobuf:"varint,2,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

func (*StoredTask) Descriptor deprecated

func (*StoredTask) Descriptor() ([]byte, []int)

Deprecated: Use StoredTask.ProtoReflect.Descriptor instead.

func (*StoredTask) GetTask

func (x *StoredTask) GetTask() *v1.Task

func (*StoredTask) GetVersion

func (x *StoredTask) GetVersion() int64

func (*StoredTask) ProtoMessage

func (*StoredTask) ProtoMessage()

func (*StoredTask) ProtoReflect

func (x *StoredTask) ProtoReflect() protoreflect.Message

func (*StoredTask) Reset

func (x *StoredTask) Reset()

func (*StoredTask) String

func (x *StoredTask) String() string

type TaskStoreServiceClient

type TaskStoreServiceClient interface {
	// CreateTask persists a new SDK task. Retrying the same task and payload
	// returns its original version; a different creation with that ID conflicts.
	CreateTask(ctx context.Context, in *TaskStoreServiceCreateTaskRequest, opts ...grpc.CallOption) (*TaskStoreServiceCreateTaskResponse, error)
	GetTask(ctx context.Context, in *TaskStoreServiceGetTaskRequest, opts ...grpc.CallOption) (*TaskStoreServiceGetTaskResponse, error)
	UpdateTask(ctx context.Context, in *TaskStoreServiceUpdateTaskRequest, opts ...grpc.CallOption) (*TaskStoreServiceUpdateTaskResponse, error)
	ListTasks(ctx context.Context, in *TaskStoreServiceListTasksRequest, opts ...grpc.CallOption) (*TaskStoreServiceListTasksResponse, error)
	// SettleTask acknowledges that native execution and SDK cleanup have stopped
	// at this saved version and publishes its task state and history atomically.
	// Runtime pause/suspend and checkpoint snapshot readiness are independent.
	SettleTask(ctx context.Context, in *TaskStoreServiceSettleTaskRequest, opts ...grpc.CallOption) (*TaskStoreServiceSettleTaskResponse, error)
}

TaskStoreServiceClient is the client API for TaskStoreService service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.

TaskStoreService is the private persistence API for agent runtimes. Every call requires workload authority for the requested session. Public user and share credentials do not grant access to this service.

type TaskStoreServiceCreateTaskRequest

type TaskStoreServiceCreateTaskRequest struct {
	SessionId string   `protobuf:"bytes,1,opt,name=session_id,json=sessionId,proto3" json:"session_id,omitempty"`
	Task      *v1.Task `protobuf:"bytes,2,opt,name=task,proto3" json:"task,omitempty"`
	// Gateway attempt fence, consumed by the first active save before native work.
	DispatchId *string `protobuf:"bytes,3,opt,name=dispatch_id,json=dispatchId,proto3,oneof" json:"dispatch_id,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceCreateTaskRequest) Descriptor deprecated

func (*TaskStoreServiceCreateTaskRequest) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceCreateTaskRequest.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceCreateTaskRequest) GetDispatchId

func (x *TaskStoreServiceCreateTaskRequest) GetDispatchId() string

func (*TaskStoreServiceCreateTaskRequest) GetSessionId

func (x *TaskStoreServiceCreateTaskRequest) GetSessionId() string

func (*TaskStoreServiceCreateTaskRequest) GetTask

func (*TaskStoreServiceCreateTaskRequest) ProtoMessage

func (*TaskStoreServiceCreateTaskRequest) ProtoMessage()

func (*TaskStoreServiceCreateTaskRequest) ProtoReflect

func (*TaskStoreServiceCreateTaskRequest) Reset

func (*TaskStoreServiceCreateTaskRequest) String

type TaskStoreServiceCreateTaskResponse

type TaskStoreServiceCreateTaskResponse struct {
	Version int64 `protobuf:"varint,1,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceCreateTaskResponse) Descriptor deprecated

func (*TaskStoreServiceCreateTaskResponse) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceCreateTaskResponse.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceCreateTaskResponse) GetVersion

func (x *TaskStoreServiceCreateTaskResponse) GetVersion() int64

func (*TaskStoreServiceCreateTaskResponse) ProtoMessage

func (*TaskStoreServiceCreateTaskResponse) ProtoMessage()

func (*TaskStoreServiceCreateTaskResponse) ProtoReflect

func (*TaskStoreServiceCreateTaskResponse) Reset

func (*TaskStoreServiceCreateTaskResponse) String

type TaskStoreServiceGetTaskRequest

type TaskStoreServiceGetTaskRequest struct {
	SessionId string `protobuf:"bytes,1,opt,name=session_id,json=sessionId,proto3" json:"session_id,omitempty"`
	TaskId    string `protobuf:"bytes,2,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceGetTaskRequest) Descriptor deprecated

func (*TaskStoreServiceGetTaskRequest) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceGetTaskRequest.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceGetTaskRequest) GetSessionId

func (x *TaskStoreServiceGetTaskRequest) GetSessionId() string

func (*TaskStoreServiceGetTaskRequest) GetTaskId

func (x *TaskStoreServiceGetTaskRequest) GetTaskId() string

func (*TaskStoreServiceGetTaskRequest) ProtoMessage

func (*TaskStoreServiceGetTaskRequest) ProtoMessage()

func (*TaskStoreServiceGetTaskRequest) ProtoReflect

func (*TaskStoreServiceGetTaskRequest) Reset

func (x *TaskStoreServiceGetTaskRequest) Reset()

func (*TaskStoreServiceGetTaskRequest) String

type TaskStoreServiceGetTaskResponse

type TaskStoreServiceGetTaskResponse struct {
	Stored *StoredTask `protobuf:"bytes,1,opt,name=stored,proto3" json:"stored,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceGetTaskResponse) Descriptor deprecated

func (*TaskStoreServiceGetTaskResponse) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceGetTaskResponse.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceGetTaskResponse) GetStored

func (*TaskStoreServiceGetTaskResponse) ProtoMessage

func (*TaskStoreServiceGetTaskResponse) ProtoMessage()

func (*TaskStoreServiceGetTaskResponse) ProtoReflect

func (*TaskStoreServiceGetTaskResponse) Reset

func (*TaskStoreServiceGetTaskResponse) String

type TaskStoreServiceListTasksRequest

type TaskStoreServiceListTasksRequest struct {
	SessionId string               `protobuf:"bytes,1,opt,name=session_id,json=sessionId,proto3" json:"session_id,omitempty"`
	Request   *v1.ListTasksRequest `protobuf:"bytes,2,opt,name=request,proto3" json:"request,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceListTasksRequest) Descriptor deprecated

func (*TaskStoreServiceListTasksRequest) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceListTasksRequest.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceListTasksRequest) GetRequest

func (*TaskStoreServiceListTasksRequest) GetSessionId

func (x *TaskStoreServiceListTasksRequest) GetSessionId() string

func (*TaskStoreServiceListTasksRequest) ProtoMessage

func (*TaskStoreServiceListTasksRequest) ProtoMessage()

func (*TaskStoreServiceListTasksRequest) ProtoReflect

func (*TaskStoreServiceListTasksRequest) Reset

func (*TaskStoreServiceListTasksRequest) String

type TaskStoreServiceListTasksResponse

type TaskStoreServiceListTasksResponse struct {
	Result *v1.ListTasksResponse `protobuf:"bytes,1,opt,name=result,proto3" json:"result,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceListTasksResponse) Descriptor deprecated

func (*TaskStoreServiceListTasksResponse) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceListTasksResponse.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceListTasksResponse) GetResult

func (*TaskStoreServiceListTasksResponse) ProtoMessage

func (*TaskStoreServiceListTasksResponse) ProtoMessage()

func (*TaskStoreServiceListTasksResponse) ProtoReflect

func (*TaskStoreServiceListTasksResponse) Reset

func (*TaskStoreServiceListTasksResponse) String

type TaskStoreServiceServer

type TaskStoreServiceServer interface {
	// CreateTask persists a new SDK task. Retrying the same task and payload
	// returns its original version; a different creation with that ID conflicts.
	CreateTask(context.Context, *TaskStoreServiceCreateTaskRequest) (*TaskStoreServiceCreateTaskResponse, error)
	GetTask(context.Context, *TaskStoreServiceGetTaskRequest) (*TaskStoreServiceGetTaskResponse, error)
	UpdateTask(context.Context, *TaskStoreServiceUpdateTaskRequest) (*TaskStoreServiceUpdateTaskResponse, error)
	ListTasks(context.Context, *TaskStoreServiceListTasksRequest) (*TaskStoreServiceListTasksResponse, error)
	// SettleTask acknowledges that native execution and SDK cleanup have stopped
	// at this saved version and publishes its task state and history atomically.
	// Runtime pause/suspend and checkpoint snapshot readiness are independent.
	SettleTask(context.Context, *TaskStoreServiceSettleTaskRequest) (*TaskStoreServiceSettleTaskResponse, error)
	// contains filtered or unexported methods
}

TaskStoreServiceServer is the server API for TaskStoreService service. All implementations must embed UnimplementedTaskStoreServiceServer for forward compatibility.

TaskStoreService is the private persistence API for agent runtimes. Every call requires workload authority for the requested session. Public user and share credentials do not grant access to this service.

type TaskStoreServiceSettleTaskRequest

type TaskStoreServiceSettleTaskRequest struct {
	SessionId string `protobuf:"bytes,1,opt,name=session_id,json=sessionId,proto3" json:"session_id,omitempty"`
	TaskId    string `protobuf:"bytes,2,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
	Version   int64  `protobuf:"varint,3,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceSettleTaskRequest) Descriptor deprecated

func (*TaskStoreServiceSettleTaskRequest) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceSettleTaskRequest.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceSettleTaskRequest) GetSessionId

func (x *TaskStoreServiceSettleTaskRequest) GetSessionId() string

func (*TaskStoreServiceSettleTaskRequest) GetTaskId

func (*TaskStoreServiceSettleTaskRequest) GetVersion

func (x *TaskStoreServiceSettleTaskRequest) GetVersion() int64

func (*TaskStoreServiceSettleTaskRequest) ProtoMessage

func (*TaskStoreServiceSettleTaskRequest) ProtoMessage()

func (*TaskStoreServiceSettleTaskRequest) ProtoReflect

func (*TaskStoreServiceSettleTaskRequest) Reset

func (*TaskStoreServiceSettleTaskRequest) String

type TaskStoreServiceSettleTaskResponse

type TaskStoreServiceSettleTaskResponse struct {
	// contains filtered or unexported fields
}

func (*TaskStoreServiceSettleTaskResponse) Descriptor deprecated

func (*TaskStoreServiceSettleTaskResponse) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceSettleTaskResponse.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceSettleTaskResponse) ProtoMessage

func (*TaskStoreServiceSettleTaskResponse) ProtoMessage()

func (*TaskStoreServiceSettleTaskResponse) ProtoReflect

func (*TaskStoreServiceSettleTaskResponse) Reset

func (*TaskStoreServiceSettleTaskResponse) String

type TaskStoreServiceUpdateTaskRequest

type TaskStoreServiceUpdateTaskRequest struct {
	SessionId       string   `protobuf:"bytes,1,opt,name=session_id,json=sessionId,proto3" json:"session_id,omitempty"`
	Task            *v1.Task `protobuf:"bytes,2,opt,name=task,proto3" json:"task,omitempty"`
	ExpectedVersion int64    `protobuf:"varint,3,opt,name=expected_version,json=expectedVersion,proto3" json:"expected_version,omitempty"`
	// Go's SDK supplies the triggering event. Snapshot-only SDKs omit it; the
	// task then describes the complete update. History is archived separately.
	Event      *v1.StreamResponse `protobuf:"bytes,4,opt,name=event,proto3" json:"event,omitempty"`
	DispatchId *string            `protobuf:"bytes,5,opt,name=dispatch_id,json=dispatchId,proto3,oneof" json:"dispatch_id,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceUpdateTaskRequest) Descriptor deprecated

func (*TaskStoreServiceUpdateTaskRequest) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceUpdateTaskRequest.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceUpdateTaskRequest) GetDispatchId

func (x *TaskStoreServiceUpdateTaskRequest) GetDispatchId() string

func (*TaskStoreServiceUpdateTaskRequest) GetEvent

func (*TaskStoreServiceUpdateTaskRequest) GetExpectedVersion

func (x *TaskStoreServiceUpdateTaskRequest) GetExpectedVersion() int64

func (*TaskStoreServiceUpdateTaskRequest) GetSessionId

func (x *TaskStoreServiceUpdateTaskRequest) GetSessionId() string

func (*TaskStoreServiceUpdateTaskRequest) GetTask

func (*TaskStoreServiceUpdateTaskRequest) ProtoMessage

func (*TaskStoreServiceUpdateTaskRequest) ProtoMessage()

func (*TaskStoreServiceUpdateTaskRequest) ProtoReflect

func (*TaskStoreServiceUpdateTaskRequest) Reset

func (*TaskStoreServiceUpdateTaskRequest) String

type TaskStoreServiceUpdateTaskResponse

type TaskStoreServiceUpdateTaskResponse struct {

	// Retrying the same expected version and payload returns the original
	// committed version, including after subsequent updates have committed.
	Version int64 `protobuf:"varint,1,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

func (*TaskStoreServiceUpdateTaskResponse) Descriptor deprecated

func (*TaskStoreServiceUpdateTaskResponse) Descriptor() ([]byte, []int)

Deprecated: Use TaskStoreServiceUpdateTaskResponse.ProtoReflect.Descriptor instead.

func (*TaskStoreServiceUpdateTaskResponse) GetVersion

func (x *TaskStoreServiceUpdateTaskResponse) GetVersion() int64

func (*TaskStoreServiceUpdateTaskResponse) ProtoMessage

func (*TaskStoreServiceUpdateTaskResponse) ProtoMessage()

func (*TaskStoreServiceUpdateTaskResponse) ProtoReflect

func (*TaskStoreServiceUpdateTaskResponse) Reset

func (*TaskStoreServiceUpdateTaskResponse) String

type UnimplementedTaskStoreServiceServer

type UnimplementedTaskStoreServiceServer struct{}

UnimplementedTaskStoreServiceServer must be embedded to have forward compatible implementations.

NOTE: this should be embedded by value instead of pointer to avoid a nil pointer dereference when methods are called.

type UnsafeTaskStoreServiceServer

type UnsafeTaskStoreServiceServer interface {
	// contains filtered or unexported methods
}

UnsafeTaskStoreServiceServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to TaskStoreServiceServer will result in compilation errors.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL