# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for TextQL Ontology Management Service API version: 1.0.0 extends: openapi/textql-ontologymanagementservice-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-10-01' generator: build-phrasing.py label: Generated by API Evangelist operations: 69 - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/AddOntologySubmodule'].post update: x-apievangelist-phrasing: intent: Add a git submodule to the Ontology effect: write questions: - Can I pull another git repository into my TextQL Ontology as a submodule? - Which branch does an Ontology submodule track when I mount an external repo? instructions: - text: Add the repo at {url} as an Ontology submodule mounted at {path}. slots: url: requestBody.url path: requestBody.path - text: Mount submodule {url} at {path} tracking branch {branch}. slots: url: requestBody.url path: requestBody.path branch: requestBody.branch method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ApprovePatch'].post update: x-apievangelist-phrasing: intent: Approve a pending Ontology patch effect: write questions: - What do I need to sign off on a patch someone proposed to the Ontology? - Why does approving an Ontology patch ask for the expected git ref? instructions: - text: Approve Ontology patch {patchId} at git ref {expectedGitRef}. slots: patchId: requestBody.patchId expectedGitRef: requestBody.expectedGitRef - text: Give my approval to patch {patchId} so it can merge. slots: patchId: requestBody.patchId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ConfigureOntologyRemote'].post update: x-apievangelist-phrasing: intent: Connect the Ontology to a remote git repository effect: write questions: - How do I link my Ontology to a hosted git repo so changes sync both ways? - 'Which auth methods can the Ontology git remote use: access token, SSH key or an app installation?' - Can I sign commits that the Ontology pushes to its remote? instructions: - text: Set the Ontology git remote to {remoteUrl} with default branch {defaultBranch}. slots: remoteUrl: requestBody.remoteUrl defaultBranch: requestBody.defaultBranch - text: Connect the Ontology to {remoteUrl} using auth type {authType} and push mode {pushMode}. slots: remoteUrl: requestBody.remoteUrl authType: requestBody.authType pushMode: requestBody.pushMode - text: Configure remote {remoteUrl} through the hosted git app integration. slots: remoteUrl: requestBody.remoteUrl method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateApprovalRule'].post update: x-apievangelist-phrasing: intent: Create an Ontology approval rule effect: write questions: - Can I require a certain number of reviewers before Ontology patches merge? - What does a new approval rule for Ontology folders look like? instructions: - text: Create a new Ontology approval rule defined as {rule}. slots: rule: requestBody.rule - text: Add approval rule {rule} to govern patch merges. slots: rule: requestBody.rule method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateContextPatchAutoApproveRule'].post update: x-apievangelist-phrasing: intent: Create a rule that auto-approves context patches effect: write questions: - Can some context patches merge automatically without a human reviewer? - How do I set up auto-approval for low-risk context changes? instructions: - text: 'Create a context patch auto-approve rule: {rule}.' slots: rule: requestBody.rule - text: Add auto-approve rule {rule} so matching context patches skip review. slots: rule: requestBody.rule method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateOntologyDirectory'].post update: x-apievangelist-phrasing: intent: Create a folder in the Ontology effect: write questions: - How do I add a new folder to the Ontology library? - Does creating an Ontology directory produce a commit with a message? instructions: - text: Create Ontology directory {path}. slots: path: requestBody.path - text: Make folder {path} in the Ontology with commit message {commitMessage}. slots: path: requestBody.path commitMessage: requestBody.commitMessage method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/CreateOntologyFileUploadUrl'].post update: x-apievangelist-phrasing: intent: Get an upload URL for a new Ontology file effect: write questions: - How do I upload a large binary file into the Ontology? - Do I need to state the MIME type and size before uploading an Ontology file? instructions: - text: Get an upload URL for Ontology file {path} of type {mimeType} and {sizeBytes} bytes. slots: path: requestBody.path mimeType: requestBody.mimeType sizeBytes: requestBody.sizeBytes - text: Start an upload for {path} into the Ontology. slots: path: requestBody.path method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteApprovalRule'].post update: x-apievangelist-phrasing: intent: Delete an Ontology approval rule effect: destructive questions: - How do I remove an approval rule that patches no longer need to satisfy? - What happens to merge requirements when I delete an approval rule? instructions: - text: Delete Ontology approval rule {id}. slots: id: requestBody.id - text: Remove the merge approval requirement with rule id {id}. slots: id: requestBody.id method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteContextPatchAutoApproveRule'].post update: x-apievangelist-phrasing: intent: Delete a context patch auto-approve rule effect: destructive questions: - How do I stop context patches from being auto-approved? - Can I drop a single auto-approve rule and keep the others? instructions: - text: Delete context patch auto-approve rule {id}. slots: id: requestBody.id - text: Turn off auto-approval by removing rule {id}. slots: id: requestBody.id method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteOntologyDirectory'].post update: x-apievangelist-phrasing: intent: Delete a folder from the Ontology effect: destructive questions: - Can I delete an Ontology folder along with everything inside it? - What happens if I remove a non-empty Ontology directory without the recursive flag? instructions: - text: Delete Ontology directory {path} recursively. slots: path: requestBody.path - text: Remove folder {path} from the Ontology with commit message {commitMessage}. slots: path: requestBody.path commitMessage: requestBody.commitMessage method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DeleteOntologyFile'].post update: x-apievangelist-phrasing: intent: Delete a file from the Ontology effect: destructive questions: - How do I delete a single file from the Ontology library? - Is deleting an Ontology file recorded as a commit? instructions: - text: Delete Ontology file {path}. slots: path: requestBody.path - text: Remove file {path} from the Ontology, committing with {commitMessage}. slots: path: requestBody.path commitMessage: requestBody.commitMessage method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/DenyPatch'].post update: x-apievangelist-phrasing: intent: Deny a pending Ontology patch effect: write questions: - How do I reject a patch someone proposed to the Ontology? - Can a denied Ontology patch be brought back later? instructions: - text: Deny Ontology patch {patchId} at git ref {expectedGitRef}. slots: patchId: requestBody.patchId expectedGitRef: requestBody.expectedGitRef - text: Reject proposed patch {patchId}. slots: patchId: requestBody.patchId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ExchangeOntologyGithubCode'].post update: x-apievangelist-phrasing: intent: Finish GitHub OAuth for the Ontology remote effect: write questions: - After the git host redirects back, how do I complete the Ontology connection with the auth code? - Does finishing the Ontology git OAuth flow need a PKCE code verifier? instructions: - text: Exchange OAuth code {code} with state {state} to finish linking the Ontology repo. slots: code: requestBody.code state: requestBody.state - text: Complete the Ontology repo OAuth using code {code} and verifier {codeVerifier}. slots: code: requestBody.code codeVerifier: requestBody.codeVerifier method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/FinalizeOntologyFileUpload'].post update: x-apievangelist-phrasing: intent: Commit an uploaded file into the Ontology effect: write questions: - Once my file is uploaded, how do I commit it into the Ontology? - What upload key do I pass to finalize an Ontology file upload? instructions: - text: Finalize the upload {uploadKey} as Ontology file {path}. slots: uploadKey: requestBody.uploadKey path: requestBody.path - text: Commit uploaded file {path} with message {commitMessage}. slots: path: requestBody.path commitMessage: requestBody.commitMessage method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetCodeownerCoverage'].post update: x-apievangelist-phrasing: intent: Check how much of the Ontology has owners effect: read questions: - Which parts of my Ontology have no code owners assigned? - How much of the Ontology is covered by OWNERS rules? instructions: - text: Show the Ontology's codeowner coverage. - text: Report OWNERS coverage across the Ontology, timing out after {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetConfigExportCapabilities'].post update: x-apievangelist-phrasing: intent: See which objects can be exported as config effect: read questions: - Which object types can I save into the Ontology as config files? - Am I allowed to export dashboards and playbooks as config? instructions: - text: List my config export capabilities. - text: Check config export permissions with a {timeout_ms} ms timeout. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetEffectiveOntologyOwners'].post update: x-apievangelist-phrasing: intent: Get the owners that actually apply to a path effect: read questions: - Who effectively owns this Ontology path once inherited OWNERS rules are applied? - Which owners govern a file that has no OWNERS entry of its own? instructions: - text: Show the effective owners for Ontology path {path}. slots: path: requestBody.path - text: Resolve inherited ownership for {path}. slots: path: requestBody.path method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetFileUsage'].post update: x-apievangelist-phrasing: intent: Rank Ontology files by usage effect: read questions: - Which Ontology files get used the most in chats? - Can I see file usage for just one folder over a chosen period? instructions: - text: Rank Ontology files under {pathPrefix} by usage over {observationPeriod}. slots: pathPrefix: requestBody.pathPrefix observationPeriod: requestBody.observationPeriod - text: List file usage sorted {order}, {pageSize} per page. slots: order: requestBody.order pageSize: requestBody.pageSize method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetFileUsageTimeline'].post update: x-apievangelist-phrasing: intent: Chart Ontology file usage over time effect: read questions: - How has usage of files in an Ontology folder trended over time? - Is there a day-by-day timeline of Ontology file usage? instructions: - text: Show the usage timeline for files under {pathPrefix}. slots: pathPrefix: requestBody.pathPrefix - text: Chart file usage under {pathPrefix} across {observationPeriod}. slots: pathPrefix: requestBody.pathPrefix observationPeriod: requestBody.observationPeriod method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyAnaConfig'].post update: x-apievangelist-phrasing: intent: Read the Ana config for an Ontology folder effect: read questions: - What Ana configuration is set on this Ontology folder? - Is auto-attach turned on for a given Ontology path? instructions: - text: Get the Ana config at Ontology path {path}. slots: path: requestBody.path - text: Show auto-attach and codeowner settings for {path}. slots: path: requestBody.path method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyFile'].post update: x-apievangelist-phrasing: intent: Read a file from the Ontology effect: read questions: - How do I fetch the contents of one Ontology file? - Can I read a context file straight from the Ontology library? instructions: - text: Open Ontology file {path}. slots: path: requestBody.path - text: Show me the current contents of {path} in the Ontology. slots: path: requestBody.path method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyGithubOAuthURL'].post update: x-apievangelist-phrasing: intent: Start GitHub OAuth for the Ontology remote effect: read questions: - Where do I send a user to authorize repo access for the Ontology? - Does the Ontology repo authorize link support a PKCE code challenge? instructions: - text: Get the repo OAuth authorize URL for the Ontology with state {state}. slots: state: requestBody.state - text: Build the Ontology repo authorize link using challenge {codeChallenge}. slots: codeChallenge: requestBody.codeChallenge method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyHistoryFileDiff'].post update: x-apievangelist-phrasing: intent: Show a file's diff in a past Ontology commit effect: read questions: - What changed in a specific file in an earlier Ontology commit? - Can I see the diff for one path in Ontology history? instructions: - text: Show the diff of {path} in Ontology commit {commitId}. slots: path: requestBody.path commitId: requestBody.commitId - text: Show the file diff from Ontology commit {commitId}. slots: commitId: requestBody.commitId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyOwners'].post update: x-apievangelist-phrasing: intent: Read the OWNERS entries set on a path effect: read questions: - What OWNERS entries are defined directly on this Ontology folder? - How do I check who is listed as owner of a specific Ontology path? instructions: - text: Get the OWNERS entries declared on {path}. slots: path: requestBody.path - text: List owners configured on Ontology folder {path}. slots: path: requestBody.path method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyRemote'].post update: x-apievangelist-phrasing: intent: Show the Ontology's git remote settings effect: read questions: - Which git repository is my Ontology connected to? - What push mode and default branch does the Ontology remote use? instructions: - text: Show the Ontology git remote configuration. - text: Fetch remote settings for the Ontology within {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologySizeTimeline'].post update: x-apievangelist-phrasing: intent: Track the Ontology's size over time effect: read questions: - How has the number of files in my Ontology grown? - Is there a size history for the Ontology over a chosen period? instructions: - text: Show the Ontology size timeline for {observationPeriod}. slots: observationPeriod: requestBody.observationPeriod - text: Chart how big the Ontology has gotten. method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologySyncConflicts'].post update: x-apievangelist-phrasing: intent: List git sync conflicts in the Ontology effect: read questions: - Are there merge conflicts blocking my Ontology from syncing with its remote? - Which files conflict between the Ontology and the remote repo? instructions: - text: Show outstanding Ontology sync conflicts. - text: Check for remote sync conflicts with a {timeout_ms} ms deadline. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetOntologyUsageSummary'].post update: x-apievangelist-phrasing: intent: Summarize Ontology usage effect: read questions: - How heavily is the Ontology being used overall? - Can I get a headline usage summary of the Ontology for the last period? instructions: - text: Summarize Ontology usage over {observationPeriod}. slots: observationPeriod: requestBody.observationPeriod - text: Give me the overall Ontology usage summary. method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetPatch'].post update: x-apievangelist-phrasing: intent: Get an Ontology patch by id effect: read questions: - How do I look up an Ontology patch using its id? - Can I view an older revision of an Ontology patch? instructions: - text: Get Ontology patch {patchId}. slots: patchId: requestBody.patchId - text: Show revision {revision} of patch {patchId}. slots: revision: requestBody.revision patchId: requestBody.patchId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetPatchByNumber'].post update: x-apievangelist-phrasing: intent: Get an Ontology patch by its number effect: read questions: - Can I open an Ontology patch using its short number instead of the id? - Where do I find patch number 42 from the review list? instructions: - text: Open Ontology patch number {number}. slots: number: requestBody.number - text: Look up the patch numbered {number}. slots: number: requestBody.number method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetPatchCapabilities'].post update: x-apievangelist-phrasing: intent: See what actions I can take on a patch effect: read questions: - Am I allowed to approve, deny or revert this Ontology patch? - Which review actions are open to me on a given patch? instructions: - text: Check my capabilities on patch {patchId}. slots: patchId: requestBody.patchId - text: Tell me which actions I can take on Ontology patch {patchId}. slots: patchId: requestBody.patchId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetRawPatch'].post update: x-apievangelist-phrasing: intent: Download the raw diff of an Ontology patch effect: read questions: - Can I get the raw git patch text for an Ontology change? - How do I export a patch as a plain diff? instructions: - text: Get the raw patch text for patch number {patchNumber}. slots: patchNumber: requestBody.patchNumber - text: Export patch {patchNumber} as a unified diff. slots: patchNumber: requestBody.patchNumber method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/GetUsageDetailsForFile'].post update: x-apievangelist-phrasing: intent: Get usage details for one Ontology file effect: read questions: - How often is a particular Ontology file used, and by whom? - Can I drill into the usage of a single file over a period? instructions: - text: Show usage details for Ontology file {filePath}. slots: filePath: requestBody.filePath - text: Break down usage of {filePath} over {observationPeriod}. slots: filePath: requestBody.filePath observationPeriod: requestBody.observationPeriod method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListApprovalRules'].post update: x-apievangelist-phrasing: intent: List Ontology approval rules effect: read questions: - What approval rules currently gate Ontology patch merges? - Which folders require reviewers before patches can merge? instructions: - text: List all Ontology approval rules. - text: Show the approval rules, waiting at most {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListChatsForFile'].post update: x-apievangelist-phrasing: intent: List chats that used an Ontology file effect: read questions: - Which chats pulled in a given Ontology file? - Can I see the conversations that referenced a context file recently? instructions: - text: List chats that used {filePath}. slots: filePath: requestBody.filePath - text: Show up to {limit} chats referencing {filePath} during {observationPeriod}. slots: limit: requestBody.limit filePath: requestBody.filePath observationPeriod: requestBody.observationPeriod method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListContextPatchAutoApproveRules'].post update: x-apievangelist-phrasing: intent: List context patch auto-approve rules effect: read questions: - Which rules let context patches merge without review? - What auto-approve rules exist for context patches today? instructions: - text: List the context patch auto-approve rules. - text: Show all auto-approve rules with a {timeout_ms} ms timeout. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListGoldenFiles'].post update: x-apievangelist-phrasing: intent: List Ontology files marked golden (deprecated) effect: read questions: - Which Ontology files are flagged as golden? - Is the golden files list still supported now that OWNERS exists? instructions: - text: List the golden Ontology files. - text: Fetch the legacy golden file list within {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologyEntries'].post update: x-apievangelist-phrasing: intent: Browse files and folders in the Ontology effect: read questions: - How do I browse the contents of an Ontology folder? - Can I list everything under an Ontology path recursively, including debug files? instructions: - text: List the entries in Ontology folder {path}. slots: path: requestBody.path - text: Recursively list everything under {path} in the Ontology. slots: path: requestBody.path method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologyHistory'].post update: x-apievangelist-phrasing: intent: List the Ontology's commit history effect: read questions: - What is the recent commit history of my Ontology? - Can I see the change history for just one Ontology path? instructions: - text: Show the Ontology commit history for {path}. slots: path: requestBody.path - text: List the last {pageSize} Ontology commits. slots: pageSize: requestBody.pageSize method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologyImports'].post update: x-apievangelist-phrasing: intent: List imports into the Ontology effect: read questions: - What has been imported into my Ontology? - Is there a record of Ontology imports I can review? instructions: - text: List Ontology imports. - text: Show the Ontology import list, waiting up to {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologySubmodules'].post update: x-apievangelist-phrasing: intent: List git submodules in the Ontology effect: read questions: - Which external repos are mounted as submodules in the Ontology? - Where are the Ontology submodules mounted and which branches do they track? instructions: - text: List the Ontology's submodules. - text: Show every mounted submodule with a {timeout_ms} ms timeout. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListOntologySyncRuns'].post update: x-apievangelist-phrasing: intent: List past Ontology sync runs effect: read questions: - When did the Ontology last sync with its git remote, and did it succeed? - Can I page through the history of Ontology sync runs? instructions: - text: List recent Ontology sync runs. - text: Show {pageSize} sync runs starting from page token {pageToken}. slots: pageSize: requestBody.pageSize pageToken: requestBody.pageToken method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListPatchObjects'].post update: x-apievangelist-phrasing: intent: List the config objects in a patch effect: read questions: - Which playbooks and dashboards does a patch's config touch? - Can I see the display names and types of objects at a patch's git ref? instructions: - text: List the config objects in patch ref {patchRef}. slots: patchRef: requestBody.patchRef - text: Show object types and Library paths at {patchRef}. slots: patchRef: requestBody.patchRef method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListPatchReviewers'].post update: x-apievangelist-phrasing: intent: List reviewers on an Ontology patch effect: read questions: - Who has been asked to review this Ontology patch? - Which reviewers are assigned to a given patch? instructions: - text: List reviewers for patch {patchId}. slots: patchId: requestBody.patchId - text: Show who is reviewing Ontology patch {patchId}. slots: patchId: requestBody.patchId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListPatches'].post update: x-apievangelist-phrasing: intent: List Ontology patches effect: read questions: - What Ontology patches are open and waiting for review? - Can I filter Ontology patches by status and hide auto-approved ones? instructions: - text: List Ontology patches with status {statuses}. slots: statuses: requestBody.statuses - text: Show the {pageSize} most recent patches, including auto-approved ones. slots: pageSize: requestBody.pageSize method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ListSkills'].post update: x-apievangelist-phrasing: intent: List skills available in the Ontology effect: read questions: - Which skills can I invoke with the slash autocomplete in chat? - Can I include unlisted skills when listing Ontology skills? instructions: - text: List the Ontology skills I can read. - text: List skills with include unlisted set to {includeUnlisted}. slots: includeUnlisted: requestBody.includeUnlisted method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/PlanOntologyMerge'].post update: x-apievangelist-phrasing: intent: Plan a merge between the Ontology and remote effect: read questions: - What would a merge between my Ontology and its remote branch look like? - Can I plan an Ontology merge before running it? instructions: - text: Plan the Ontology merge with the remote. - text: Produce an Ontology merge plan within {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/PreviewOntologyPullFromRemote'].post update: x-apievangelist-phrasing: intent: Preview pulling remote changes into the Ontology effect: read questions: - What would change if I pulled the latest commits from the Ontology's remote? - Can I see incoming remote changes before pulling them into the Ontology? instructions: - text: Preview a pull from the Ontology remote. - text: Show incoming remote commits without applying them, timeout {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/PullOntologyFromRemote'].post update: x-apievangelist-phrasing: intent: Pull remote git changes into the Ontology effect: write questions: - How do I bring the latest commits from the remote repo into my Ontology? - Can I pull from a remote whose history is unrelated to the Ontology's? instructions: - text: Pull the Ontology from its remote, expecting remote head {expectedRemoteHeadHash}. slots: expectedRemoteHeadHash: requestBody.expectedRemoteHeadHash - text: Pull remote changes onto local head {expectedLocalHeadHash}, acknowledging unrelated histories. slots: expectedLocalHeadHash: requestBody.expectedLocalHeadHash method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/PushOntologyToRemote'].post update: x-apievangelist-phrasing: intent: Push the Ontology to its git remote effect: write questions: - How do I push my Ontology's commits up to the connected repo? - Can I force an Ontology push instead of waiting for the sync interval? instructions: - text: Push the Ontology to its remote now. - text: Push Ontology commits upstream, allowing {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/RecoverOntology'].post update: x-apievangelist-phrasing: intent: Recover a broken Ontology effect: destructive questions: - My Ontology repo is in a bad state; can I recover it? - What recovery levels are available when restoring the Ontology? instructions: - text: Recover the Ontology at level {level}. slots: level: requestBody.level - text: Run Ontology recovery using recovery level {level}. slots: level: requestBody.level method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/RemoveOntologyRemote'].post update: x-apievangelist-phrasing: intent: Disconnect the Ontology from its git remote effect: destructive questions: - How do I unlink my Ontology from the remote repo it syncs with? - What happens to syncing once the Ontology remote is removed? instructions: - text: Remove the Ontology's git remote. - text: Disconnect the remote repo from the Ontology with a {timeout_ms} ms timeout. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/RemoveOntologySubmodule'].post update: x-apievangelist-phrasing: intent: Remove a git submodule from the Ontology effect: destructive questions: - How do I unmount an external repo that was added as an Ontology submodule? - Can I drop a submodule without touching the rest of the Ontology? instructions: - text: Remove the Ontology submodule at {path}. slots: path: requestBody.path - text: Unmount submodule {path}. slots: path: requestBody.path method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/RenameOntologyFile'].post update: x-apievangelist-phrasing: intent: Rename or move an Ontology file effect: write questions: - How do I rename a file in the Ontology? - Can I move an Ontology file to another folder in one commit? instructions: - text: Rename Ontology file {oldPath} to {newPath}. slots: oldPath: requestBody.oldPath newPath: requestBody.newPath - text: Move {oldPath} to {newPath} with commit message {commitMessage}. slots: oldPath: requestBody.oldPath newPath: requestBody.newPath commitMessage: requestBody.commitMessage method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/RequestPatchReview'].post update: x-apievangelist-phrasing: intent: Request a review on an Ontology patch effect: write questions: - How do I ask a teammate to review my Ontology patch? - Can I assign a specific member as reviewer on a patch? instructions: - text: Request review of patch {patchId} from member {reviewerMemberId}. slots: patchId: requestBody.patchId reviewerMemberId: requestBody.reviewerMemberId - text: Ask {reviewerMemberId} to review my Ontology patch. slots: reviewerMemberId: requestBody.reviewerMemberId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ResolveOntologySyncConflict'].post update: x-apievangelist-phrasing: intent: Resolve an Ontology sync conflict effect: write questions: - How do I fix a merge conflict between the Ontology and its remote? - Can I supply the resolved file content for a sync conflict? instructions: - text: Resolve sync conflict {conflictId} with content {resolvedContent}. slots: conflictId: requestBody.conflictId resolvedContent: requestBody.resolvedContent - text: Mark Ontology conflict {conflictId} as resolved. slots: conflictId: requestBody.conflictId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/RestorePatch'].post update: x-apievangelist-phrasing: intent: Restore a denied Ontology patch effect: write questions: - Can I reopen an Ontology patch that was denied? - How do I bring a rejected patch back into review? instructions: - text: Restore denied patch {patchId} at git ref {expectedGitRef}. slots: patchId: requestBody.patchId expectedGitRef: requestBody.expectedGitRef - text: Reopen rejected Ontology patch {patchId}. slots: patchId: requestBody.patchId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/RevertPatch'].post update: x-apievangelist-phrasing: intent: Revert a merged Ontology patch effect: destructive questions: - How do I undo a patch that already merged into the Ontology? - Can I roll back the changes a merged patch made? instructions: - text: Revert merged patch {patchId}. slots: patchId: requestBody.patchId - text: Undo the Ontology changes from patch {patchId}. slots: patchId: requestBody.patchId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/SaveAllObjectsAsConfig'].post update: x-apievangelist-phrasing: intent: Export all objects of a type as Ontology config effect: write questions: - Can I save every playbook or dashboard into the Ontology as config files at once? - How do I bulk-export all objects of one type as config? instructions: - text: Save all {objectType} objects as Ontology config. slots: objectType: requestBody.objectType - text: Bulk-export every object of type {objectType} into config files. slots: objectType: requestBody.objectType method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/SaveObjectAsConfig'].post update: x-apievangelist-phrasing: intent: Export one object as Ontology config effect: write questions: - How do I save a single dashboard or playbook into the Ontology as config? - Can I version one specific object as a config file? instructions: - text: Save {objectType} {objectId} as Ontology config. slots: objectType: requestBody.objectType objectId: requestBody.objectId - text: Export object {objectId} to a config file. slots: objectId: requestBody.objectId method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/SetOntologyFileGolden'].post update: x-apievangelist-phrasing: intent: Mark an Ontology file golden (deprecated) effect: write questions: - How do I flag an Ontology file as golden? - Is marking files golden deprecated in favor of OWNERS entries? instructions: - text: Mark Ontology file {path} as golden. slots: path: requestBody.path - text: Set the golden flag on {path} to {golden}. slots: path: requestBody.path golden: requestBody.golden method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/SetOntologyOwners'].post update: x-apievangelist-phrasing: intent: Set the OWNERS entries for an Ontology path effect: write questions: - How do I assign owners to an Ontology folder? - Does sending an empty owner set open the directory to everyone? instructions: - text: Set owners on {path} to {entries}. slots: path: requestBody.path entries: requestBody.entries - text: Replace the OWNERS entries for {path} and commit with {commitMessage}. slots: path: requestBody.path commitMessage: requestBody.commitMessage method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/TriggerConfigDriftReconcile'].post update: x-apievangelist-phrasing: intent: Force a config drift reconcile now effect: write questions: - Can I make TextQL catch up config objects with the Ontology immediately? - How do I trigger a config-sync reconcile instead of waiting for the periodic one? instructions: - text: Trigger a config drift reconcile for my org. - text: Reconcile config with the Ontology HEAD now, timing out at {timeout_ms} ms. slots: timeout_ms: header.Connect-Timeout-Ms method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/UpdateApprovalRule'].post update: x-apievangelist-phrasing: intent: Change an existing Ontology approval rule effect: write questions: - How do I edit the requirements of an approval rule I already created? - Can I change how many approvers an existing rule demands? instructions: - text: Update approval rule {id} to {rule}. slots: id: requestBody.id rule: requestBody.rule - text: Modify existing Ontology approval rule {id}. slots: id: requestBody.id method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/UpdateContextPatchAutoApproveRule'].post update: x-apievangelist-phrasing: intent: Change an existing auto-approve rule effect: write questions: - How do I adjust an auto-approve rule for context patches that already exists? - Can I narrow which context patches an existing auto-approve rule covers? instructions: - text: Update context patch auto-approve rule {id} to {rule}. slots: id: requestBody.id rule: requestBody.rule - text: Edit existing auto-approve rule {id}. slots: id: requestBody.id method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/UpdateOntologySyncConfig'].post update: x-apievangelist-phrasing: intent: Change Ontology git sync settings effect: write questions: - How often does the Ontology sync with its remote, and can I change it? - Can I turn automatic Ontology syncing off? instructions: - text: Sync the Ontology every {syncIntervalMinutes} minutes. slots: syncIntervalMinutes: requestBody.syncIntervalMinutes - text: Set Ontology sync enabled to {syncEnabled} with push mode {pushMode}. slots: syncEnabled: requestBody.syncEnabled pushMode: requestBody.pushMode method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/UpsertOntologyAnaConfig'].post update: x-apievangelist-phrasing: intent: Create or update Ana config for a folder effect: write questions: - How do I turn on auto-attach for an Ontology folder's Ana config? - Can I set codeowners in the Ana config for a path? instructions: - text: Set Ana auto-attach on {path} to {autoAttach}. slots: path: requestBody.path autoAttach: requestBody.autoAttach - text: Write Ana config for {path} with codeowners {codeowners}. slots: path: requestBody.path codeowners: requestBody.codeowners method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/UpsertOntologyFile'].post update: x-apievangelist-phrasing: intent: Create or overwrite an Ontology file effect: write questions: - How do I write a new context file into the Ontology? - Can I overwrite an existing Ontology file's text in one call? instructions: - text: Write {content} to Ontology file {path}. slots: content: requestBody.content path: requestBody.path - text: Save file {path} in the Ontology with commit message {commitMessage}. slots: path: requestBody.path commitMessage: requestBody.commitMessage method: generated generated: '2026-10-01' - target: $.paths['/textql.rpc.public.patches.OntologyManagementService/ValidateConfig'].post update: x-apievangelist-phrasing: intent: Validate the config in a patch effect: read questions: - Will the config in my patch parse and resolve its dependencies? - Does a passing config validation guarantee the patch will merge? instructions: - text: Validate the config in patch {patchId}. slots: patchId: requestBody.patchId - text: Dry-run config validation for {patchId} without saving anything. slots: patchId: requestBody.patchId method: generated generated: '2026-10-01'