@onesi/genesis 0.2.13 → 0.2.14

package/dist/genesis.openapi.json

@@ -140,6 +140,10 @@
     {
       "name": "connections",
       "description": "Connections (verified remote MCP servers)"
+    },
+    {
+      "name": "agents",
+      "description": "Agents (public agent search)"
     }
   ],
   "paths": {
@@ -41242,6 +41246,128 @@
         "x-mcp": true
       }
     },
+    "/v1/dials/workflows/{workflow_id}": {
+      "delete": {
+        "operationId": "dials_deleteWorkflow",
+        "summary": "Delete an owned workflow and its routing descriptor",
+        "description": "Needs `dials:write`. Deletes the workflow with this id (the `id` you deployed it with) and every routing-rule descriptor row it was deployed as, in the verified org/workspace/project/environment only, and records a `workflows.delete` audit event whose actor is the verified gateway identity. Another organization's, workspace's, project's or environment's workflow, and a repeat delete, are 404 `workflow_not_found`. If a held (not released) number is assigned to the workflow (kind `workflow` or `routing_rule`), the delete is refused with 409 `workflow_number_attached` and nothing changes: unassign the number first with `assignNumber` and no resource. Managed inbound policies (`/v1/routing/rules`) are never deleted here. Scope is required in the JSON body, not query parameters.",
+        "parameters": [
+          {
+            "name": "workflow_id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 256
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/Dials.DeleteWorkflow"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Deleted. The descriptor rows are gone; audit records are kept.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.DeleteWorkflowReceipt"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid scope or request shape.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.CustomerError"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Missing or invalid verified identity.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.CustomerError"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Selected scope is not authorized by signed identity or lacks the required Dials grant.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.CustomerError"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "No workflow with this id in the authorized scope (workflow_not_found).",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.CustomerError"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A held number is assigned to this workflow (workflow_number_attached); unassign it first.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.CustomerError"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Durable store failed.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.CustomerError"
+                }
+              }
+            }
+          },
+          "503": {
+            "description": "Backend is not ready.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Dials.CustomerError"
+                }
+              }
+            }
+          }
+        },
+        "tags": [
+          "dials"
+        ],
+        "x-genesis-service": "dials",
+        "x-upstream": {
+          "base": "https://dials-808958844152.us-central1.run.app",
+          "method": "DELETE",
+          "path": "/v1/workflows/{workflow_id}",
+          "status": "unverified"
+        },
+        "x-mcp": true
+      }
+    },
     "/v1/dials/numbers/{number_id}": {
       "delete": {
         "operationId": "dials_deleteNumber",
@@ -102050,6 +102176,126 @@
         },
         "x-mcp": false
       }
+    },
+    "/v1/agents/search": {
+      "get": {
+        "operationId": "agents_search",
+        "summary": "Search public agents",
+        "description": "Public, no credential. Ranked full-text search over public Live agents: matches in the name rank above the organization name, then the description, then the agent id; every word must match, as a prefix. An exact agent id ranks that agent first. GET only, no body, no other query key. Cached at the edge for up to 30 seconds. Rate limited per client address (429 RATE_LIMITED with Retry-After).",
+        "parameters": [
+          {
+            "name": "q",
+            "in": "query",
+            "required": true,
+            "description": "What to search for, 1 to 200 characters.",
+            "schema": {
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 200
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "required": false,
+            "description": "Most results to return, 1 to 20 (default 20).",
+            "schema": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 20,
+              "default": 20
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Matching public agents, best first",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Agents.AgentSearchResults"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "INVALID_QUERY (q or limit out of range) or INVALID_REQUEST (another query key",
+            "or a body)": null
+          },
+          "405": {
+            "description": "METHOD_NOT_ALLOWED (after a credential verifies; without one",
+            "401 like every non-public path)": null
+          },
+          "429": {
+            "description": "RATE_LIMITED"
+          },
+          "502": {
+            "description": "BAD_GATEWAY (the index answered outside its contract; nothing is passed through)"
+          },
+          "503": {
+            "description": "AGENT_INDEX_UNAVAILABLE or SERVICE_DISABLED"
+          }
+        },
+        "tags": [
+          "agents"
+        ],
+        "security": [],
+        "x-genesis-service": "agents",
+        "x-upstream": {
+          "base": "https://genesis-agent-index.invalid",
+          "method": "GET",
+          "path": "/v1/agents/search",
+          "status": "not_deployed"
+        },
+        "x-mcp": true
+      }
+    },
+    "/v1/agents/sitemap": {
+      "get": {
+        "operationId": "agents_sitemap",
+        "summary": "List every public agent for crawlers",
+        "description": "Public, no credential. Every public Live agent id (at most 50,000) with when its public content last changed, for sitemaps and spiders. GET only, no query string, no body. Cached at the edge for up to 5 minutes. Rate limited per client address.",
+        "responses": {
+          "200": {
+            "description": "Public agent ids",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Agents.AgentSitemap"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "INVALID_REQUEST (a query string or a body)"
+          },
+          "405": {
+            "description": "METHOD_NOT_ALLOWED (after a credential verifies; without one",
+            "401 like every non-public path)": null
+          },
+          "429": {
+            "description": "RATE_LIMITED"
+          },
+          "502": {
+            "description": "BAD_GATEWAY"
+          },
+          "503": {
+            "description": "AGENT_INDEX_UNAVAILABLE or SERVICE_DISABLED"
+          }
+        },
+        "tags": [
+          "agents"
+        ],
+        "security": [],
+        "x-genesis-service": "agents",
+        "x-upstream": {
+          "base": "https://genesis-agent-index.invalid",
+          "method": "GET",
+          "path": "/v1/agents/sitemap",
+          "status": "not_deployed"
+        },
+        "x-mcp": true
+      }
     }
   },
   "components": {
@@ -131617,6 +131863,65 @@
         "additionalProperties": false,
         "description": "Upsert by scoped workflow ID. Backend supplies deployed status, stable route ID and enabled routing descriptor. This is persisted configuration, not runtime/telephony execution proof."
       },
+      "Dials.DeleteWorkflow": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "scope": {
+            "$ref": "#/components/schemas/Dials.Scope"
+          },
+          "actorId": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Optional compatibility field; the actual actor comes from the verified gateway identity."
+          }
+        },
+        "required": [
+          "scope"
+        ]
+      },
+      "Dials.DeleteWorkflowReceipt": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "ok": {
+            "type": "boolean",
+            "const": true
+          },
+          "deleted": {
+            "type": "boolean",
+            "const": true
+          },
+          "workflow": {
+            "$ref": "#/components/schemas/Dials.WorkflowDocument"
+          },
+          "routeIds": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "The routing-rule descriptor ids that were deleted."
+          },
+          "auditId": {
+            "type": "string"
+          },
+          "next": {
+            "type": "string",
+            "const": "workflow_deleted"
+          }
+        },
+        "required": [
+          "ok",
+          "deleted",
+          "workflow",
+          "routeIds",
+          "auditId",
+          "next"
+        ],
+        "description": "The deleted workflow as it was, with status \"deleted\"."
+      },
       "Dials.CallSession": {
         "type": "object",
         "required": [
@@ -158323,6 +158628,115 @@
             "type": "boolean"
           }
         }
+      },
+      "Agents.AgentSearchResults": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "results"
+        ],
+        "properties": {
+          "results": {
+            "type": "array",
+            "maxItems": 20,
+            "items": {
+              "$ref": "#/components/schemas/Agents.AgentSearchHit"
+            }
+          }
+        }
+      },
+      "Agents.AgentSearchHit": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "agentId",
+          "did",
+          "verified",
+          "environment"
+        ],
+        "description": "One public agent. Optional keys are omitted when the owner did not disclose them.",
+        "properties": {
+          "agentId": {
+            "type": "string",
+            "pattern": "^a_[A-Za-z0-9]{1,64}$",
+            "description": "The agent's IAM id (a_...)"
+          },
+          "did": {
+            "type": "string",
+            "description": "The agent's canonical DID (did:oas:agent:...)"
+          },
+          "verified": {
+            "type": "boolean",
+            "const": true,
+            "description": "IAM vouches for this public identity"
+          },
+          "environment": {
+            "type": "string",
+            "const": "live",
+            "description": "Always live; Sandbox agents are never indexed"
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 120,
+            "description": "The agent's name (when disclosed)"
+          },
+          "owner": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "name"
+            ],
+            "description": "The owning organization (when its name is disclosed). Never a person.",
+            "properties": {
+              "name": {
+                "type": "string",
+                "maxLength": 120
+              }
+            }
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 300,
+            "description": "The owner's public description (when disclosed)"
+          },
+          "createdAt": {
+            "type": "integer",
+            "description": "When the agent was created",
+            "in milliseconds since the epoch (when disclosed)": null
+          }
+        }
+      },
+      "Agents.AgentSitemap": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "agents"
+        ],
+        "properties": {
+          "agents": {
+            "type": "array",
+            "maxItems": 50000,
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "agentId",
+                "updatedAt"
+              ],
+              "properties": {
+                "agentId": {
+                  "type": "string",
+                  "pattern": "^a_[A-Za-z0-9]{1,64}$"
+                },
+                "updatedAt": {
+                  "type": "integer",
+                  "description": "When the agent's public content last changed",
+                  "in milliseconds since the epoch": null
+                }
+              }
+            }
+          }
+        }
       }
     },
     "responses": {
@@ -160244,7 +160658,7 @@
       "upstream": "https://dials-808958844152.us-central1.run.app",
       "status": "unverified",
       "statusNote": "Backend healthy; Genesis signed-identity integration pending deployment and acceptance.",
-      "operations": 37
+      "operations": 38
     },
     {
       "name": "silos",
@@ -160421,6 +160835,15 @@
       "statusNote": "Closed gateway admission behind CONNECTIONS_GATEWAY_ENABLED (default off): /v1/connections/* with a v2 signed identity and selected context (API key, M2M token or login session); connections:read for GET, connections:write otherwise, connections:* both. Sandbox in P0; Live only through UPSTREAM_CONNECTIONS_LIVE once connections is in GENESIS_LIVE_SERVICES. GET /v1/connections/oauth/callback is anonymous (a person's browser after vendor consent): no credential is read or forwarded and no identity envelope is sent. connections_authorize is a human-consent operation the hosted MCP refuses. Tool results and vendor descriptions are wrapped as untrusted. Vendor tokens live in Blinds only.",
       "gatewayRoute": "dedicated",
       "operations": 13
+    },
+    {
+      "name": "agents",
+      "title": "Agents (public agent search)",
+      "upstream": "https://genesis-agent-index.invalid",
+      "status": "not_deployed",
+      "statusNote": "genesis-agent-index (l1felabs/genesis-agent-index) is not deployed. The gateway admits it behind AGENT_INDEX_ENABLED with AGENT_INDEX_ORIGIN (gateway/src/agent-index.ts): public and anonymous (no credential is read or forwarded), rate limited per client address, never metered. Live public agents only.",
+      "gatewayRoute": "dedicated",
+      "operations": 2
     }
   ]
 }

package/dist/index.d.ts

@@ -29,8 +29,9 @@ export { gardenModule } from './garden.js';
 export { orgsEntitiesModule, type OrgsDocumentContent } from './orgs.js';
 export { scopesModule } from './scopes.js';
 export { billingModule, creditsModule, gatewayModule, orgsModule } from './gateway.js';
+export { agentsModule, AGENT_SEARCH_LIMIT_MAX, AGENT_SEARCH_Q_MAX, type AgentSearchHit, type AgentSitemapEntry } from './agents.js';
 export { boxesModule } from './boxes.js';
-export { dialsModule, dialsEmergencyAddressFeedback, type DialsEmergencyAddressFeedback, type DialsScope, type DialsOutboundCall, type DialsCallControl, type DialsEmergencyAddress, type DialsCallListItem, type DialsCallDispatchState, type DialsMessage, type DialsMessageTemplate, type DialsMessagingBrand, type DialsMessagingCampaign, type DialsWorkflowDocument, type DialsRoutingAction, type DialsRoutingRule, type DialsRoutingRuleReceipt, type DialsOutboundCallReceipt, type DialsRecoveredOutboundCallReceipt } from './dials.js';
+export { dialsModule, dialsEmergencyAddressFeedback, type DialsEmergencyAddressFeedback, type DialsScope, type DialsOutboundCall, type DialsCallControl, type DialsEmergencyAddress, type DialsCallListItem, type DialsCallDispatchState, type DialsMessage, type DialsMessageTemplate, type DialsMessagingBrand, type DialsMessagingCampaign, type DialsWorkflowDocument, type DialsWorkflowDeleteReceipt, type DialsRoutingAction, type DialsRoutingRule, type DialsRoutingRuleReceipt, type DialsOutboundCallReceipt, type DialsRecoveredOutboundCallReceipt } from './dials.js';
 export { hivesObjectKey, type HivesBucket, type HivesObject, type HivesObjectAcknowledgement, type HivesStorageWriteReplay, type HivesObjectList, type HivesCorsRule, type HivesCreateBucket, type HivesPresign, type HivesPresignedUrl } from './hives-cells.js';
 export { hivesSseEvents, hivesSseReader, type HivesLogStreamEvent, type HivesLogStreamQuery, type HivesLogWindow, type HivesLogWindowOptions } from './hives-platform.js';
 export { hivesQueueBody, type HivesQueue, type HivesQueueConfig, type HivesQueueCreate, type HivesQueueSend, type HivesQueueDelivery, type HivesDeadLetter, type HivesDeadLetterStats } from './hives-queues.js';

package/dist/index.js

@@ -24,6 +24,7 @@ export { gardenModule } from './garden.js';
 export { orgsEntitiesModule } from './orgs.js';
 export { scopesModule } from './scopes.js';
 export { billingModule, creditsModule, gatewayModule, orgsModule } from './gateway.js';
+export { agentsModule, AGENT_SEARCH_LIMIT_MAX, AGENT_SEARCH_Q_MAX } from './agents.js';
 export { boxesModule } from './boxes.js';
 export { dialsModule, dialsEmergencyAddressFeedback } from './dials.js';
 export { hivesObjectKey } from './hives-cells.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onesi/genesis",
-  "version": "0.2.13",
+  "version": "0.2.14",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/l1felabs/genesis-api.git",