@stigmer/protos 0.0.69 → 0.0.70

package/ai/stigmer/platform/github/v1/service_pb.d.ts

@@ -5,13 +5,15 @@ import type { Message } from "@bufbuild/protobuf";
  */
 export declare const file_ai_stigmer_platform_github_v1_service: GenFile;
 /**
- * Request to get the OAuth authorize URL.
+ * Input for requesting a GitHub OAuth authorize URL.
  *
  * @generated from message ai.stigmer.platform.github.v1.GetOAuthAuthorizeUrlRequest
  */
 export type GetOAuthAuthorizeUrlRequest = Message<"ai.stigmer.platform.github.v1.GetOAuthAuthorizeUrlRequest"> & {
     /**
-     * The URI that GitHub will redirect back to after the user authorizes.
+     * Callback URI that GitHub redirects to after the user authorizes.
+     *
+     * @internal
      * Must match one of the callback URLs registered on the GitHub App.
      *
      * @generated from field: string redirect_uri = 1;
@@ -24,20 +26,20 @@ export type GetOAuthAuthorizeUrlRequest = Message<"ai.stigmer.platform.github.v1
  */
 export declare const GetOAuthAuthorizeUrlRequestSchema: GenMessage<GetOAuthAuthorizeUrlRequest>;
 /**
- * Response containing the constructed OAuth authorize URL.
+ * Result of requesting a GitHub OAuth authorize URL.
  *
  * @generated from message ai.stigmer.platform.github.v1.GetOAuthAuthorizeUrlResponse
  */
 export type GetOAuthAuthorizeUrlResponse = Message<"ai.stigmer.platform.github.v1.GetOAuthAuthorizeUrlResponse"> & {
     /**
-     * The full GitHub OAuth authorize URL to redirect the user to.
+     * Full GitHub OAuth authorize URL to redirect the user to.
      *
      * @generated from field: string authorize_url = 1;
      */
     authorizeUrl: string;
     /**
-     * A random state value for CSRF protection. The frontend must verify
-     * this matches the state returned in the callback.
+     * Random state value for CSRF protection.
+     * Pass this back in ExchangeOAuthCodeRequest to verify the callback.
      *
      * @generated from field: string state = 2;
      */
@@ -49,26 +51,28 @@ export type GetOAuthAuthorizeUrlResponse = Message<"ai.stigmer.platform.github.v
  */
 export declare const GetOAuthAuthorizeUrlResponseSchema: GenMessage<GetOAuthAuthorizeUrlResponse>;
 /**
- * Request to exchange an authorization code for an access token.
+ * Input for exchanging a GitHub authorization code for an access token.
  *
  * @generated from message ai.stigmer.platform.github.v1.ExchangeOAuthCodeRequest
  */
 export type ExchangeOAuthCodeRequest = Message<"ai.stigmer.platform.github.v1.ExchangeOAuthCodeRequest"> & {
     /**
-     * The authorization code received from GitHub's OAuth redirect.
+     * Authorization code received from GitHub's OAuth redirect callback.
      *
      * @generated from field: string code = 1;
      */
     code: string;
     /**
-     * The state value from the original authorize request, for CSRF verification.
+     * State value from the original authorize response, for CSRF verification.
      *
      * @generated from field: string state = 2;
      */
     state: string;
     /**
-     * The redirect_uri used in the original authorize request.
-     * GitHub requires this to match for the token exchange.
+     * Redirect URI used in the original authorize request.
+     *
+     * @internal
+     * GitHub requires this to match the value from the authorize step.
      *
      * @generated from field: string redirect_uri = 3;
      */
@@ -80,25 +84,25 @@ export type ExchangeOAuthCodeRequest = Message<"ai.stigmer.platform.github.v1.Ex
  */
 export declare const ExchangeOAuthCodeRequestSchema: GenMessage<ExchangeOAuthCodeRequest>;
 /**
- * Response containing the exchanged access token.
+ * Result of exchanging a GitHub authorization code for an access token.
  *
  * @generated from message ai.stigmer.platform.github.v1.ExchangeOAuthCodeResponse
  */
 export type ExchangeOAuthCodeResponse = Message<"ai.stigmer.platform.github.v1.ExchangeOAuthCodeResponse"> & {
     /**
-     * The GitHub access token for API calls.
+     * GitHub access token for API calls.
      *
      * @generated from field: string access_token = 1;
      */
     accessToken: string;
     /**
-     * The token type (typically "bearer").
+     * Token type (typically "bearer").
      *
      * @generated from field: string token_type = 2;
      */
     tokenType: string;
     /**
-     * The granted OAuth scopes (comma-separated).
+     * Granted OAuth scopes, comma-separated.
      *
      * @generated from field: string scope = 3;
      */
@@ -112,28 +116,32 @@ export declare const ExchangeOAuthCodeResponseSchema: GenMessage<ExchangeOAuthCo
 /**
  * GitHubService provides OAuth integration with GitHub.
  *
- * This is a platform utility service — not a domain resource.
- * It enables the web console (and SDK consumers) to connect a user's
- * GitHub account via OAuth, then browse and select repositories
- * for workspace configuration.
- *
- * The service handles the server-side OAuth code exchange (protecting
- * the client_secret) and provides the authorize URL so the frontend
- * does not need to know the client_id or redirect_uri.
+ * Use this service to connect a GitHub account via OAuth and obtain
+ * an access token for GitHub API calls. The service manages the
+ * authorize URL construction and the authorization-code-for-token
+ * exchange so callers do not handle OAuth details directly.
  *
- * Tokens are ephemeral — they are returned to the caller and never
- * persisted by the backend.
+ * @internal
+ * This is a platform utility service — not a domain resource.
+ * The backend protects the client_secret during the token exchange
+ * and constructs the authorize URL with the registered client_id and
+ * redirect_uri so the frontend never needs those values.
+ * Tokens are ephemeral — returned to the caller and never persisted.
  *
  * @generated from service ai.stigmer.platform.github.v1.GitHubService
  */
 export declare const GitHubService: GenService<{
     /**
-     * Returns the GitHub OAuth authorize URL for initiating the OAuth flow.
+     * Get the GitHub OAuth authorize URL for initiating the OAuth flow.
+     *
+     * Returns a URL to redirect the user to and a random state value for
+     * CSRF protection. After the user authorizes, GitHub redirects back
+     * to your redirect_uri with an authorization code.
      *
+     * @internal
      * The backend constructs the URL with the registered client_id, requested
-     * scopes, and a random state parameter for CSRF protection. The frontend
-     * redirects the user to this URL, and GitHub redirects back to the
-     * provided redirect_uri with an authorization code.
+     * scopes, and the state parameter. Authorization is skipped because this
+     * is a pre-authentication step.
      *
      * @generated from rpc ai.stigmer.platform.github.v1.GitHubService.getOAuthAuthorizeUrl
      */
@@ -143,16 +151,17 @@ export declare const GitHubService: GenService<{
         output: typeof GetOAuthAuthorizeUrlResponseSchema;
     };
     /**
-     * Exchanges a GitHub OAuth authorization code for an access token.
+     * Exchange a GitHub OAuth authorization code for an access token.
      *
-     * The frontend calls this after receiving the authorization code from
-     * GitHub's OAuth redirect. The backend makes the token exchange request
-     * to GitHub using the client_secret (which must never be exposed to
-     * the frontend).
+     * Call this after receiving the authorization code from GitHub's OAuth
+     * redirect. Pass the code, the state from the original authorize request,
+     * and the same redirect_uri. Returns an access token for GitHub API calls.
      *
-     * The returned access_token is NOT stored by the backend. The frontend
-     * is responsible for persisting it (e.g., in localStorage) and including
-     * it in subsequent requests that need GitHub access.
+     * @internal
+     * The backend performs the token exchange using the client_secret, which
+     * must never be exposed to the frontend. The returned access_token is NOT
+     * stored by the backend — the caller is responsible for persisting it and
+     * including it in subsequent requests that need GitHub access.
      *
      * @generated from rpc ai.stigmer.platform.github.v1.GitHubService.exchangeOAuthCode
      */

package/ai/stigmer/platform/github/v1/service_pb.js

@@ -31,17 +31,17 @@ export const ExchangeOAuthCodeResponseSchema = /*@__PURE__*/ messageDesc(file_ai
 /**
  * GitHubService provides OAuth integration with GitHub.
  *
- * This is a platform utility service — not a domain resource.
- * It enables the web console (and SDK consumers) to connect a user's
- * GitHub account via OAuth, then browse and select repositories
- * for workspace configuration.
- *
- * The service handles the server-side OAuth code exchange (protecting
- * the client_secret) and provides the authorize URL so the frontend
- * does not need to know the client_id or redirect_uri.
+ * Use this service to connect a GitHub account via OAuth and obtain
+ * an access token for GitHub API calls. The service manages the
+ * authorize URL construction and the authorization-code-for-token
+ * exchange so callers do not handle OAuth details directly.
  *
- * Tokens are ephemeral — they are returned to the caller and never
- * persisted by the backend.
+ * @internal
+ * This is a platform utility service — not a domain resource.
+ * The backend protects the client_secret during the token exchange
+ * and constructs the authorize URL with the registered client_id and
+ * redirect_uri so the frontend never needs those values.
+ * Tokens are ephemeral — returned to the caller and never persisted.
  *
  * @generated from service ai.stigmer.platform.github.v1.GitHubService
  */

package/ai/stigmer/platform/github/v1/service_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"service_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/platform/github/v1/service_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,0HAA0H;AAC1H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAChJ,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAY,aAAa,CAC9E,QAAQ,CAAC,o8BAAo8B,EAAE,CAAC,gEAAgE,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAiBjjC;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAA4C,aAAa,CACrG,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAwB7D;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAA6C,aAAa,CACvG,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AA+B7D;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyC,aAAa,CAC/F,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AA8B7D;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAA0C,aAAa,CACjG,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAmCrB,aAAa,CAChB,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"service_pb.js","sourceRoot":"","sources":["../../../../../../ai/stigmer/platform/github/v1/service_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,0HAA0H;AAC1H,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAClF,OAAO,EAAE,gEAAgE,EAAE,MAAM,8DAA8D,CAAC;AAChJ,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAGrF;;GAEG;AACH,MAAM,CAAC,MAAM,0CAA0C,GAAY,aAAa,CAC9E,QAAQ,CAAC,o8BAAo8B,EAAE,CAAC,gEAAgE,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAmBjjC;;;GAGG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAA4C,aAAa,CACrG,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAwB7D;;;GAGG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAA6C,aAAa,CACvG,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAiC7D;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyC,aAAa,CAC/F,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AA8B7D;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAA0C,aAAa,CACjG,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,aAAa,GAwCrB,aAAa,CAChB,WAAW,CAAC,0CAA0C,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/search/v1/io_pb.d.ts

@@ -16,19 +16,12 @@ export declare const file_ai_stigmer_search_v1_io: GenFile;
  * - Search: Find resources matching a text query
  * - Discover: Search across all resource kinds
  *
+ * @internal
  * Examples:
- *
- * List agents in an organization:
- *   {kinds: [agent], org: "acme", query: ""}
- *
- * Search agents by text:
- *   {kinds: [agent], query: "code review"}
- *
- * Discover all resources matching a query:
- *   {kinds: [], query: "kubernetes"}
- *
- * Search multiple kinds:
- *   {kinds: [agent, skill], query: "security", org: "acme"}
+ *   List agents in org:         {kinds: [agent], org: "acme", query: ""}
+ *   Search agents by text:      {kinds: [agent], query: "code review"}
+ *   Discover all:               {kinds: [], query: "kubernetes"}
+ *   Search multiple kinds:      {kinds: [agent, skill], query: "security", org: "acme"}
  *
  * @generated from message ai.stigmer.search.v1.SearchRequest
  */
@@ -42,6 +35,7 @@ export type SearchRequest = Message<"ai.stigmer.search.v1.SearchRequest"> & {
      * - Single kind: Search only that resource type
      * - Multiple kinds: Search specified types
      *
+     * @internal
      * Invalid kinds are silently ignored (allows forward compatibility).
      *
      * @generated from field: repeated ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceKind kinds = 1;
@@ -72,9 +66,9 @@ export type SearchRequest = Message<"ai.stigmer.search.v1.SearchRequest"> & {
      * Behavior:
      * - Empty: Search all organizations the caller has access to
      * - Non-empty: Search only within the specified organization
-     *   Caller must have access to at least one resource in the org
      *
-     * Examples: "stigmer", "acme-corp", "my-org"
+     * @internal
+     * Caller must have access to at least one resource in the org.
      *
      * @generated from field: string org = 3;
      */
@@ -114,8 +108,8 @@ export declare const SearchRequestSchema: GenMessage<SearchRequest>;
  * SearchResponse contains paginated search results with metadata.
  *
  * The response includes:
- * - Matching resources as SearchResult projections
- * - Counts per kind for UI filtering/tabs
+ * - Matching resources as SearchResult summaries
+ * - Counts per kind for filtering
  * - Pagination metadata
  *
  * @generated from message ai.stigmer.search.v1.SearchResponse
@@ -128,8 +122,8 @@ export type SearchResponse = Message<"ai.stigmer.search.v1.SearchResponse"> & {
      * - With query: Sorted by relevance score (descending)
      * - Without query: Sorted by created_at (descending, newer first)
      *
-     * Each result is a display projection, not the full resource.
-     * To get the full resource, use the kind-specific get RPC.
+     * Each result is a summary, not the full resource.
+     * To get the full resource, call the get method for that resource kind.
      *
      * @generated from field: repeated ai.stigmer.search.v1.SearchResult entries = 1;
      */
@@ -174,16 +168,17 @@ export type SearchResponse = Message<"ai.stigmer.search.v1.SearchResponse"> & {
  */
 export declare const SearchResponseSchema: GenMessage<SearchResponse>;
 /**
- * SearchResult is a display-optimized projection of an API resource.
+ * SearchResult is a lightweight summary of an API resource returned by search.
  *
  * Contains only the fields needed for search result display:
  * - Identity: kind, id, slug, org
  * - Display: name, description, tags
  * - Metadata: visibility, timestamps, relevance score
  *
- * This is NOT the full resource. Use the kind-specific QueryController
- * (e.g., AgentQueryController.get) to retrieve the complete resource.
+ * This is not the full resource. To get the complete resource, call the
+ * get method for that resource kind (e.g., client.agent.get()).
  *
+ * @internal
  * The description field is populated by each resource's Searchable interface:
  * - Agent: spec.instructions (may be truncated)
  * - Skill: spec.description
@@ -194,7 +189,7 @@ export declare const SearchResponseSchema: GenMessage<SearchResponse>;
  */
 export type SearchResult = Message<"ai.stigmer.search.v1.SearchResult"> & {
     /**
-     * Resource kind (e.g., agent, skill, mcp_server, workflow).
+     * Type of API resource this result represents (e.g., agent, skill, mcp_server).
      *
      * @generated from field: ai.stigmer.commons.apiresource.apiresourcekind.ApiResourceKind kind = 1;
      */
@@ -202,17 +197,17 @@ export type SearchResult = Message<"ai.stigmer.search.v1.SearchResult"> & {
     /**
      * System-generated unique identifier (UUID).
      *
-     * Format: Prefixed UUID (e.g., "agt-550e8400-e29b-41d4-a716-446655440000").
+     * Format: Prefixed UUID (e.g., "agt_550e8400-e29b-41d4-a716-446655440000").
      * Use this for subsequent API calls to get/update/delete the resource.
      *
      * @generated from field: string id = 2;
      */
     id: string;
     /**
-     * Human-readable display name.
+     * Human-readable display name of the resource.
      *
-     * From metadata.name. This is the user-provided name.
-     * Example: "Code Review Agent", "Web Search Skill"
+     * @internal
+     * From metadata.name.
      *
      * @generated from field: string name = 3;
      */
@@ -220,8 +215,10 @@ export type SearchResult = Message<"ai.stigmer.search.v1.SearchResult"> & {
     /**
      * URL-friendly identifier, unique within the organization.
      *
-     * From metadata.slug. Lowercase alphanumeric with hyphens.
-     * Example: "code-review-agent", "web-search"
+     * Lowercase alphanumeric with hyphens (e.g., "code-review-agent", "web-search").
+     *
+     * @internal
+     * From metadata.slug.
      *
      * @generated from field: string slug = 4;
      */
@@ -238,25 +235,26 @@ export type SearchResult = Message<"ai.stigmer.search.v1.SearchResult"> & {
      */
     qualifiedSlug: string;
     /**
-     * Organization that owns this resource.
+     * Organization that owns this resource (e.g., "stigmer", "acme-corp").
      *
-     * From metadata.org. The organization slug.
-     * Example: "stigmer", "acme-corp"
+     * @internal
+     * From metadata.org.
      *
      * @generated from field: string org = 6;
      */
     org: string;
     /**
-     * Brief description for display in search results.
+     * Brief description of the resource for display in search results.
      *
+     * May be empty if the resource has no description.
+     *
+     * @internal
      * Extracted from the resource spec via the Searchable interface.
      * The source field varies by resource type:
-     * - Agent: spec.instructions
+     * - Agent: spec.instructions (may be truncated)
      * - Skill: spec.description
      * - McpServer: spec.description
      * - Workflow: spec.description
-     *
-     * May be empty if the resource has no description.
      * Truncation for display is a presentation concern (CLI/UI responsibility).
      *
      * @generated from field: string description = 7;
@@ -272,10 +270,10 @@ export type SearchResult = Message<"ai.stigmer.search.v1.SearchResult"> & {
      */
     visibility: ApiResourceVisibility;
     /**
-     * Tags for categorization and filtering.
+     * User-provided tags for categorization and filtering.
      *
-     * From metadata.tags. User-provided labels.
-     * Example: ["security", "code-review", "ai"]
+     * @internal
+     * From metadata.tags.
      *
      * @generated from field: repeated string tags = 9;
      */
@@ -283,8 +281,10 @@ export type SearchResult = Message<"ai.stigmer.search.v1.SearchResult"> & {
     /**
      * When the resource was created.
      *
+     * Used for sorting in list mode (when no query is provided).
+     *
+     * @internal
      * From status.audit.created_at.
-     * Used for sorting in list mode (no query).
      *
      * @generated from field: google.protobuf.Timestamp created_at = 10;
      */
@@ -292,8 +292,8 @@ export type SearchResult = Message<"ai.stigmer.search.v1.SearchResult"> & {
     /**
      * When the resource was last updated.
      *
+     * @internal
      * From status.audit.updated_at.
-     * Useful for showing recency in search results.
      *
      * @generated from field: google.protobuf.Timestamp updated_at = 11;
      */

package/ai/stigmer/search/v1/io_pb.js.map

@@ -1 +1 @@
-{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../ai/stigmer/search/v1/io_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mGAAmG;AACnG,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qEAAqE,EAAE,MAAM,gEAAgE,CAAC;AAEvJ,OAAO,EAAE,wCAAwC,EAAE,MAAM,mCAAmC,CAAC;AAE7F,OAAO,EAAE,sCAAsC,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAY,aAAa,CAChE,QAAQ,CAAC,6vCAA6vC,EAAE,CAAC,qEAAqE,EAAE,wCAAwC,EAAE,sCAAsC,EAAE,0BAA0B,EAAE,8BAA8B,CAAC,CAAC,CAAC;AAwGj+C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC;AA8D/C;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC;AA0J/C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC"}
+{"version":3,"file":"io_pb.js","sourceRoot":"","sources":["../../../../../ai/stigmer/search/v1/io_pb.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,mGAAmG;AACnG,oBAAoB;AAGpB,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,qEAAqE,EAAE,MAAM,gEAAgE,CAAC;AAEvJ,OAAO,EAAE,wCAAwC,EAAE,MAAM,mCAAmC,CAAC;AAE7F,OAAO,EAAE,sCAAsC,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AAGxE;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAY,aAAa,CAChE,QAAQ,CAAC,6vCAA6vC,EAAE,CAAC,qEAAqE,EAAE,wCAAwC,EAAE,sCAAsC,EAAE,0BAA0B,EAAE,8BAA8B,CAAC,CAAC,CAAC;AAkGj+C;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA8B,aAAa,CACzE,WAAW,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC;AA8D/C;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAA+B,aAAa,CAC3E,WAAW,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC;AAgK/C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6B,aAAa,CACvE,WAAW,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC"}

package/ai/stigmer/search/v1/query_connect.d.ts

@@ -1,18 +1,24 @@
 /**
- * SearchService provides unified search across all API resources.
+ * SearchService provides unified search and discovery across API resources.
  *
- * This is a CQRS Query Service operating on the read-side of the system.
- * It queries multiple domain aggregates (Agent, Skill, McpServer, Workflow)
- * and returns display-optimized projections. It does not modify state.
+ * A single RPC handles listing, searching, and discovering resources.
+ * The behavior depends on the combination of request parameters:
+ * specify kinds to filter by resource type, provide a query for full-text
+ * search, or leave both empty to list all accessible resources.
+ *
+ * Results only include resources the caller has permission to view.
+ *
+ * @internal
+ * This is a CQRS Query Service on the read-side. It queries multiple domain
+ * aggregates (Agent, Skill, McpServer, Workflow) and returns display-optimized
+ * projections. It does not modify state.
  *
- * Architectural Note:
  * Search is cross-aggregate query infrastructure, not a domain bounded context.
  * It lives in the query layer (CQRS read-side), not the domain layer.
  * Therefore, it does not have an api_resource_kind option like domain services.
  *
- * Authorization Model:
- * Unlike domain services that use declarative authorization options,
- * SearchService handles authorization programmatically in the handler:
+ * Authorization is handled programmatically in the handler (not via
+ * declarative authorization options like domain services):
  * 1. Call FGA to get authorized resource IDs per requested kind
  * 2. Apply filters (org, query, exclude_public) against authorized set
  * 3. Return only resources the caller has can_view permission on
@@ -35,25 +41,25 @@ export declare const SearchService: {
          * This is the unified entry point for list, search, and discover operations.
          * The behavior is determined by the combination of request parameters:
          *
-         * | Operation | kinds     | query | org     | Behavior                              |
-         * |-----------|-----------|-------|---------|---------------------------------------|
-         * | List      | [X]       | ""    | "acme"  | All X in org, sorted by created_at    |
-         * | List All  | [X]       | ""    | ""      | All accessible X, sorted by created_at|
-         * | Search    | [X]       | "..."  | ""      | Search X by query, sorted by relevance|
-         * | Search Org| [X]       | "..."  | "acme"  | Search X in org, sorted by relevance  |
-         * | Discover  | []        | "..."  | ""      | Search all kinds, sorted by relevance |
+         * | Operation  | kinds   | query | org    | Behavior                               |
+         * |------------|---------|-------|--------|----------------------------------------|
+         * | List       | [X]     | ""    | "acme" | All X in org, sorted by created_at     |
+         * | List All   | [X]     | ""    | ""     | All accessible X, sorted by created_at |
+         * | Search     | [X]     | "..." | ""     | Search X by query, sorted by relevance |
+         * | Search Org | [X]     | "..." | "acme" | Search X in org, sorted by relevance   |
+         * | Discover   | []      | "..." | ""     | Search all kinds, sorted by relevance  |
          *
          * Sort Order:
          * - With query: Results sorted by relevance score (descending)
          * - Without query: Results sorted by created_at (descending, newer first)
          *
-         * Authorization:
-         * Returns only resources the caller has can_view permission on.
-         * The handler queries FGA per kind to get authorized IDs, then applies filters.
-         *
          * Pagination:
          * Use page.num (1-indexed) and page.size to paginate results.
-         * Response includes total_count and total_pages for UI pagination controls.
+         * Response includes total_count and total_pages for pagination controls.
+         *
+         * @internal
+         * Authorization: Returns only resources the caller has can_view permission on.
+         * The handler queries FGA per kind to get authorized IDs, then applies filters.
          *
          * @generated from rpc ai.stigmer.search.v1.SearchService.search
          */

package/ai/stigmer/search/v1/query_connect.js

@@ -4,20 +4,26 @@
 // @ts-nocheck
 import { MethodKind } from "@bufbuild/protobuf";
 /**
- * SearchService provides unified search across all API resources.
+ * SearchService provides unified search and discovery across API resources.
  *
- * This is a CQRS Query Service operating on the read-side of the system.
- * It queries multiple domain aggregates (Agent, Skill, McpServer, Workflow)
- * and returns display-optimized projections. It does not modify state.
+ * A single RPC handles listing, searching, and discovering resources.
+ * The behavior depends on the combination of request parameters:
+ * specify kinds to filter by resource type, provide a query for full-text
+ * search, or leave both empty to list all accessible resources.
+ *
+ * Results only include resources the caller has permission to view.
+ *
+ * @internal
+ * This is a CQRS Query Service on the read-side. It queries multiple domain
+ * aggregates (Agent, Skill, McpServer, Workflow) and returns display-optimized
+ * projections. It does not modify state.
  *
- * Architectural Note:
  * Search is cross-aggregate query infrastructure, not a domain bounded context.
  * It lives in the query layer (CQRS read-side), not the domain layer.
  * Therefore, it does not have an api_resource_kind option like domain services.
  *
- * Authorization Model:
- * Unlike domain services that use declarative authorization options,
- * SearchService handles authorization programmatically in the handler:
+ * Authorization is handled programmatically in the handler (not via
+ * declarative authorization options like domain services):
  * 1. Call FGA to get authorized resource IDs per requested kind
  * 2. Apply filters (org, query, exclude_public) against authorized set
  * 3. Return only resources the caller has can_view permission on
@@ -40,25 +46,25 @@ export const SearchService = {
          * This is the unified entry point for list, search, and discover operations.
          * The behavior is determined by the combination of request parameters:
          *
-         * | Operation | kinds     | query | org     | Behavior                              |
-         * |-----------|-----------|-------|---------|---------------------------------------|
-         * | List      | [X]       | ""    | "acme"  | All X in org, sorted by created_at    |
-         * | List All  | [X]       | ""    | ""      | All accessible X, sorted by created_at|
-         * | Search    | [X]       | "..."  | ""      | Search X by query, sorted by relevance|
-         * | Search Org| [X]       | "..."  | "acme"  | Search X in org, sorted by relevance  |
-         * | Discover  | []        | "..."  | ""      | Search all kinds, sorted by relevance |
+         * | Operation  | kinds   | query | org    | Behavior                               |
+         * |------------|---------|-------|--------|----------------------------------------|
+         * | List       | [X]     | ""    | "acme" | All X in org, sorted by created_at     |
+         * | List All   | [X]     | ""    | ""     | All accessible X, sorted by created_at |
+         * | Search     | [X]     | "..." | ""     | Search X by query, sorted by relevance |
+         * | Search Org | [X]     | "..." | "acme" | Search X in org, sorted by relevance   |
+         * | Discover   | []      | "..." | ""     | Search all kinds, sorted by relevance  |
          *
          * Sort Order:
          * - With query: Results sorted by relevance score (descending)
          * - Without query: Results sorted by created_at (descending, newer first)
          *
-         * Authorization:
-         * Returns only resources the caller has can_view permission on.
-         * The handler queries FGA per kind to get authorized IDs, then applies filters.
-         *
          * Pagination:
          * Use page.num (1-indexed) and page.size to paginate results.
-         * Response includes total_count and total_pages for UI pagination controls.
+         * Response includes total_count and total_pages for pagination controls.
+         *
+         * @internal
+         * Authorization: Returns only resources the caller has can_view permission on.
+         * The handler queries FGA per kind to get authorized IDs, then applies filters.
          *
          * @generated from rpc ai.stigmer.search.v1.SearchService.search
          */

package/ai/stigmer/search/v1/query_connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../ai/stigmer/search/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sGAAsG;AACtG,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,oCAAoC;IAC9C,OAAO,EAAE;QACP;;;;;;;;;;;;;;;;;;;;;;;;;;;WA2BG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,aAAa;YAChB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}
+{"version":3,"file":"query_connect.js","sourceRoot":"","sources":["../../../../../ai/stigmer/search/v1/query_connect.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,sGAAsG;AACtG,oBAAoB;AACpB,cAAc;AAGd,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,QAAQ,EAAE,oCAAoC;IAC9C,OAAO,EAAE;QACP;;;;;;;;;;;;;;;;;;;;;;;;;;;WA2BG;QACH,MAAM,EAAE;YACN,IAAI,EAAE,QAAQ;YACd,CAAC,EAAE,aAAa;YAChB,CAAC,EAAE,cAAc;YACjB,IAAI,EAAE,UAAU,CAAC,KAAK;SACvB;KACF;CACO,CAAC"}