feat(proto): add search summaries for modules/setups and mission cost…

.task/checksum/lint

@@ -0,0 +1 @@
+983ce0c7462bd60269f34ccf1e520dad

proto/agentic_mesh_protocol/filesystem/v1/filesystem.proto

@@ -56,6 +56,18 @@ enum FileStatus {
   FILE_STATUS_DELETED = 5;
 }
 
+// Visibility represents the access scope of a file.
+enum Visibility {
+  // VISIBILITY_UNSPECIFIED is the default unspecified value.
+  VISIBILITY_UNSPECIFIED = 0;
+  // VISIBILITY_PUBLIC indicates the file is visible to everyone.
+  VISIBILITY_PUBLIC = 1;
+  // VISIBILITY_PRIVATE indicates the file is visible only to the owner.
+  VISIBILITY_PRIVATE = 2;
+  // VISIBILITY_INTERNAL indicates the file is visible within the organisation.
+  VISIBILITY_INTERNAL = 3;
+}
+
 // File represents a stored file with comprehensive metadata.
 message File {
   // file_id: Unique identifier for the file
@@ -123,6 +135,12 @@ message File {
 
   // content: The content of the file
   bytes content = 12;
+
+  // visibility: Access scope of the file
+  Visibility visibility = 13 [
+    (buf.validate.field).required = true,
+    (buf.validate.field).enum.not_in = 0
+  ];
 }
 
 // FileFilter contains criteria for querying and filtering files.
@@ -171,6 +189,9 @@ message FileFilter {
 
   // content_type: Filter by content type
   string content_type = 14;
+
+  // visibilities: Filter by visibility (empty = no filter)
+  repeated Visibility visibilities = 15 [(buf.validate.field).repeated.items.enum.not_in = 0];
 }
 
 // FileResult wraps the result of a file operation which may succeed or fail.
@@ -228,6 +249,9 @@ message UploadFileData {
 
   // replace_if_exists: Whether to replace existing file with same name
   bool replace_if_exists = 8;
+
+  // visibility: Access scope of the file (optional; defaults server-side)
+  Visibility visibility = 9;
 }
 
 // UploadFilesRequest is the request message for uploading multiple files.
@@ -309,6 +333,9 @@ message UpdateFileRequest {
 
   // metadata: New metadata (optional, will merge with existing)
   google.protobuf.Struct metadata = 8;
+
+  // visibility: New access scope of the file (optional; defaults server-side)
+  Visibility visibility = 9;
 }
 
 // UpdateFileResponse is the response message for file update operations.

proto/agentic_mesh_protocol/filesystem/v1/filesystem_service.proto

@@ -30,7 +30,8 @@ service FilesystemService {
   // DEPRECATED: GetFile — unused in SDK, no callers.
   rpc GetFile(GetFileRequest) returns (GetFileResponse);
 
-  // DEPRECATED: GetFiles — unused in SDK, no callers.
+  // GetFiles retrieves multiple files matching the given filter,
+  // with pagination and optional visibility filtering.
   rpc GetFiles(GetFilesRequest) returns (GetFilesResponse);
 
   // UpdateFile allows updating various aspects of a file including

proto/agentic_mesh_protocol/registry/v1/registry_enums.proto

@@ -68,12 +68,26 @@ enum Visibility {
   VISIBILITY_INTERNAL = 3;
 }
 
+// Sort key for search results
+enum SortBy {
+  // Backend default: relevance when a query is set, otherwise updated_at descending
+  SORT_BY_UNSPECIFIED = 0;
+  // Name
+  SORT_BY_NAME = 1;
+  // Created at
+  SORT_BY_CREATED_AT = 2;
+  // Updated at
+  SORT_BY_UPDATED_AT = 3;
+}
+
 // ModuleType
 enum ModuleType {
   // Unspecified
   MODULE_TYPE_UNSPECIFIED = 0;
   // Archetype
   MODULE_TYPE_ARCHETYPE = 1;
   // Tool
-  MODULE_TYPE_TOOL = 2;
+  MODULE_TYPE_TOOL_MODULE = 2;
+  // Service
+  MODULE_TYPE_SERVICE = 3;
 }

proto/agentic_mesh_protocol/registry/v1/registry_models.proto

@@ -98,16 +98,18 @@ message ModuleDescriptor {
   // Cost schema
   google.protobuf.Struct cost_schema = 15 [(buf.validate.field).required = true];
 
-  // Documentation
-  string documentation = 16 [
-    (buf.validate.field).required = true,
-    (buf.validate.field).string.min_len = 1
-  ];
+  // Documentation (may be empty)
+  string documentation = 16;
 
   // Created at
   google.protobuf.Timestamp created_at = 17 [(buf.validate.field).required = true];
   // Updated at
   google.protobuf.Timestamp updated_at = 18 [(buf.validate.field).required = true];
+
+  // Tags for categorization and search filtering (lowercase recommended)
+  repeated string tags = 19 [
+    (buf.validate.field).repeated.items.string.min_len = 1
+  ];
 }
 
 // Represents your "setups" + current "setup_versions"
@@ -123,11 +125,8 @@ message SetupDescriptor {
     (buf.validate.field).required = true,
     (buf.validate.field).string.min_len = 1
   ];
-  // Documentation
-  string documentation = 3 [
-    (buf.validate.field).required = true,
-    (buf.validate.field).string.min_len = 1
-  ];
+  // Documentation (may be empty)
+  string documentation = 3;
   // Status
   SetupStatus status = 4 [
     (buf.validate.field).required = true,
@@ -180,4 +179,77 @@ message SetupDescriptor {
 
   // Resolved module info (so agents don't need another round-trip)
   ModuleDescriptor module = 13 [(buf.validate.field).required = true];
+
+  // Tags for categorization and search filtering (lowercase recommended)
+  repeated string tags = 14 [
+    (buf.validate.field).repeated.items.string.min_len = 1
+  ];
+}
+
+// Trimmed, search-oriented view of a module. Intentionally excludes the
+// network address/port (mesh-internal) and the schema Structs — resolve
+// via GetModule when wiring communication.
+message ModuleSummary {
+  // Module ID
+  string id = 1 [
+    (buf.validate.field).required = true,
+    (buf.validate.field).string.prefix = "modules:",
+    (buf.validate.field).string.min_len = 1
+  ];
+  // Name
+  string name = 2 [
+    (buf.validate.field).required = true,
+    (buf.validate.field).string.min_len = 1
+  ];
+  // Module type (tool vs archetype/kin)
+  ModuleType module_type = 3;
+  // Version
+  string version = 4;
+  // Status
+  ModuleStatus status = 5;
+  // Visibility
+  Visibility visibility = 6;
+  // Organization ID
+  string organization_id = 7;
+  // Documentation
+  string documentation = 8;
+  // Tags
+  repeated string tags = 9;
+}
+
+// Trimmed, search-oriented view of a setup. Intentionally excludes the
+// setup configuration (may contain sensitive values), owner/card ids and
+// the full module descriptor — resolve via GetSetup when invoking.
+message SetupSummary {
+  // Setup ID
+  string id = 1 [
+    (buf.validate.field).required = true,
+    (buf.validate.field).string.prefix = "setups:",
+    (buf.validate.field).string.min_len = 1
+  ];
+  // Name
+  string name = 2 [
+    (buf.validate.field).required = true,
+    (buf.validate.field).string.min_len = 1
+  ];
+  // Documentation
+  string documentation = 3;
+  // Status
+  SetupStatus status = 4;
+  // Visibility
+  Visibility visibility = 5;
+  // Organization ID
+  string organization_id = 6;
+  // Backing module
+  string module_id = 7;
+  // Backing module name (denormalized so search needs no second round-trip)
+  string module_name = 8;
+  // Backing module type (tool vs archetype/kin)
+  ModuleType module_type = 9;
+  // Current version id
+  string setup_version_id = 10;
+  // Current version label
+  string setup_version = 11;
+  // Tags
+  repeated string tags = 12;
 }