@oomol-lab/open-connector 1.9.0 → 1.9.2

package/assets/open-connector/catalog/apps/arcmira.json

@@ -0,0 +1,610 @@
+{
+  "service": "arcmira",
+  "displayName": "Arcmira",
+  "categories": [
+    "AI",
+    "Data"
+  ],
+  "homepageUrl": "https://arcmira.com",
+  "authTypes": [
+    "api_key"
+  ],
+  "auth": [
+    {
+      "type": "api_key",
+      "label": "Arcmira API key",
+      "placeholder": "arc_sk_...",
+      "description": "Create an API key in your Arcmira dashboard. API documentation: https://arcmira.com/docs. Paid reads use credits from your plan, then your on-demand budget.",
+      "extraFields": []
+    }
+  ],
+  "actions": [
+    {
+      "id": "arcmira.get_account",
+      "service": "arcmira",
+      "name": "get_account",
+      "description": "Read the connected Arcmira account, plan, credit usage and granted scopes.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false,
+        "description": "Arcmira request parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "account": {
+            "type": "object",
+            "properties": {
+              "id": {
+                "type": "string",
+                "description": "Account identifier."
+              },
+              "name": {
+                "anyOf": [
+                  {
+                    "type": "string",
+                    "description": "Account name."
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "Account name."
+              },
+              "kind": {
+                "type": "string",
+                "description": "Account category."
+              },
+              "plan": {
+                "type": "string",
+                "description": "Account plan name."
+              }
+            },
+            "additionalProperties": true,
+            "description": "Connected account details."
+          },
+          "tier": {
+            "type": "string",
+            "description": "Account access tier."
+          },
+          "scopes": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "description": "Granted permission scopes."
+            },
+            "description": "Granted permission scopes."
+          },
+          "usage": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Current credit usage."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Arcmira response fields."
+      }
+    },
+    {
+      "id": "arcmira.get_transcript",
+      "service": "arcmira",
+      "name": "get_transcript",
+      "description": "Retrieve captions or a Premium transcript for a YouTube video. Premium can start a transcript job and return pending; call again later to check it. Paid reads use credits from your plan, then your on-demand budget. Premium does not fall back to captions.",
+      "operationType": "write",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "video_id": {
+            "type": "string",
+            "description": "YouTube video ID.",
+            "pattern": "^[A-Za-z0-9_-]{11}$"
+          },
+          "quality": {
+            "type": "string",
+            "enum": [
+              "captions",
+              "premium"
+            ],
+            "description": "Transcript quality lane."
+          },
+          "language": {
+            "type": "string",
+            "description": "Up to five comma-separated caption language preferences."
+          },
+          "timestamps": {
+            "type": "boolean",
+            "description": "Return timestamped lines rather than paragraphs."
+          },
+          "start": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Window start in seconds; provide end too."
+          },
+          "end": {
+            "type": "number",
+            "minimum": 0,
+            "description": "Window end in seconds, greater than start. Premium still uses whole-video credits."
+          },
+          "retry": {
+            "type": "boolean",
+            "description": "Retry a failed Premium job under the account budget."
+          },
+          "refresh": {
+            "type": "boolean",
+            "description": "Refetch captions for a video outside the indexed catalog."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "video_id",
+          "quality"
+        ],
+        "description": "Arcmira request parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "state": {
+            "type": "string",
+            "enum": [
+              "ready",
+              "pending",
+              "failed"
+            ],
+            "description": "Transcript readiness state."
+          },
+          "quality": {
+            "type": "string",
+            "enum": [
+              "captions",
+              "premium"
+            ],
+            "description": "Transcript quality lane."
+          },
+          "video": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Video metadata when ready."
+          },
+          "video_id": {
+            "type": "string",
+            "description": "YouTube video identifier."
+          },
+          "lines": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Timestamped transcript line."
+            },
+            "description": "Timestamped transcript lines."
+          },
+          "paragraphs": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {},
+              "additionalProperties": true,
+              "description": "Transcript paragraph."
+            },
+            "description": "Transcript paragraphs."
+          },
+          "job": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Transcript job with polling guidance."
+          },
+          "last_attempt": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Failure details for a failed job."
+          },
+          "note": {
+            "type": "string",
+            "description": "Additional upstream guidance."
+          }
+        },
+        "additionalProperties": true,
+        "required": [
+          "state",
+          "quality"
+        ],
+        "description": "Arcmira response fields."
+      }
+    },
+    {
+      "id": "arcmira.resolve_entity",
+      "service": "arcmira",
+      "name": "resolve_entity",
+      "description": "Find a person, organization, product, topic or YouTube channel by name. Use the returned identifiers to scope transcript searches; ambiguous names return candidates.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "q": {
+            "type": "string",
+            "minLength": 2,
+            "description": "Name, handle or YouTube channel URL."
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "person",
+              "organization",
+              "product",
+              "topic",
+              "channel"
+            ],
+            "description": "Entity category to match."
+          },
+          "context": {
+            "type": "string",
+            "minLength": 2,
+            "maxLength": 300,
+            "description": "Extra context to distinguish names."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 15,
+            "description": "Maximum number of results."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "q"
+        ],
+        "description": "Arcmira request parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "The submitted search query."
+          },
+          "confidence": {
+            "type": "string",
+            "description": "Entity resolution confidence."
+          },
+          "best": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Entity identifier."
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "Display name."
+                  },
+                  "type": {
+                    "type": "string",
+                    "description": "Entity category."
+                  },
+                  "youtube_channel_id": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "description": "Channel identifier, when applicable."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Channel identifier, when applicable."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Entity candidate details."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Entity candidate details."
+          },
+          "suggested": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "Entity identifier."
+                  },
+                  "name": {
+                    "type": "string",
+                    "description": "Display name."
+                  },
+                  "type": {
+                    "type": "string",
+                    "description": "Entity category."
+                  },
+                  "youtube_channel_id": {
+                    "anyOf": [
+                      {
+                        "type": "string",
+                        "description": "Channel identifier, when applicable."
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ],
+                    "description": "Channel identifier, when applicable."
+                  }
+                },
+                "additionalProperties": true,
+                "description": "Entity candidate details."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Entity candidate details."
+          },
+          "candidates": {
+            "type": "array",
+            "items": {
+              "anyOf": [
+                {
+                  "type": "object",
+                  "properties": {
+                    "id": {
+                      "type": "string",
+                      "description": "Entity identifier."
+                    },
+                    "name": {
+                      "type": "string",
+                      "description": "Display name."
+                    },
+                    "type": {
+                      "type": "string",
+                      "description": "Entity category."
+                    },
+                    "youtube_channel_id": {
+                      "anyOf": [
+                        {
+                          "type": "string",
+                          "description": "Channel identifier, when applicable."
+                        },
+                        {
+                          "type": "null"
+                        }
+                      ],
+                      "description": "Channel identifier, when applicable."
+                    }
+                  },
+                  "additionalProperties": true,
+                  "description": "Entity candidate details."
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Entity candidate details."
+            },
+            "description": "Possible matching entities."
+          },
+          "ask": {
+            "anyOf": [
+              {
+                "type": "object",
+                "properties": {},
+                "additionalProperties": true,
+                "description": "Clarification choices."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Clarification choices."
+          },
+          "note": {
+            "type": "string",
+            "description": "Additional upstream guidance."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Arcmira response fields."
+      }
+    },
+    {
+      "id": "arcmira.search_transcripts",
+      "service": "arcmira",
+      "name": "search_transcripts",
+      "description": "Search indexed YouTube transcripts for timestamped passages. Filter by channels, speakers, topics, sponsors or organic mentions. Results cover Arcmira's indexed catalog.",
+      "operationType": "read",
+      "requiredScopes": [],
+      "providerPermissions": [],
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "q": {
+            "type": "string",
+            "minLength": 2,
+            "description": "One topic or phrase."
+          },
+          "channel_ids": {
+            "type": "string",
+            "description": "Comma-separated YouTube channel IDs, up to eight. Resolve names first."
+          },
+          "entity_ids": {
+            "type": "string",
+            "description": "Comma-separated entity IDs, up to eight, to scope appearances."
+          },
+          "about": {
+            "type": "string",
+            "description": "Comma-separated entity IDs discussed in the passages, up to eight."
+          },
+          "by": {
+            "type": "string",
+            "description": "Comma-separated person IDs speaking the query words, up to eight. Speaker coverage varies."
+          },
+          "kind": {
+            "type": "string",
+            "description": "Comma-separated passage classes: sponsored, organic, mention."
+          },
+          "after": {
+            "type": "string",
+            "description": "Inclusive publication date or ISO date-time."
+          },
+          "before": {
+            "type": "string",
+            "description": "Exclusive publication date or ISO date-time."
+          },
+          "source": {
+            "type": "string",
+            "enum": [
+              "arcmira_premium",
+              "creator_captions",
+              "third_party_quick"
+            ],
+            "description": "Transcript source to include."
+          },
+          "limit": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 20,
+            "description": "Maximum number of results."
+          }
+        },
+        "additionalProperties": false,
+        "required": [
+          "q"
+        ],
+        "description": "Arcmira request parameters."
+      },
+      "outputSchema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "string",
+            "description": "The submitted search query."
+          },
+          "limit": {
+            "type": "integer",
+            "description": "Maximum number of results."
+          },
+          "returned": {
+            "type": "integer",
+            "description": "Number of returned passages."
+          },
+          "chunks": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "video_id": {
+                  "type": "string",
+                  "description": "YouTube video identifier."
+                },
+                "video_title": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Source title."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Source title."
+                },
+                "channel_name": {
+                  "anyOf": [
+                    {
+                      "type": "string",
+                      "description": "Source channel."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Source channel."
+                },
+                "text": {
+                  "type": "string",
+                  "description": "Matching passage."
+                },
+                "start_seconds": {
+                  "anyOf": [
+                    {
+                      "type": "integer",
+                      "description": "Passage timestamp in seconds."
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "description": "Passage timestamp in seconds."
+                },
+                "watch_url": {
+                  "type": "string",
+                  "description": "Source video at the passage timestamp.",
+                  "format": "uri"
+                },
+                "speakers": {
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "description": "Identified speaker name."
+                  },
+                  "description": "Identified speakers."
+                }
+              },
+              "additionalProperties": true,
+              "description": "Timestamped matching passages."
+            },
+            "description": "Timestamped matching passages."
+          },
+          "filters": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Applied search filters."
+          },
+          "window": {
+            "type": "object",
+            "properties": {},
+            "additionalProperties": true,
+            "description": "Applied publication window."
+          },
+          "as_of": {
+            "anyOf": [
+              {
+                "type": "string",
+                "description": "Result freshness."
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Result freshness."
+          },
+          "note": {
+            "type": "string",
+            "description": "Additional upstream guidance."
+          }
+        },
+        "additionalProperties": true,
+        "description": "Arcmira response fields."
+      }
+    }
+  ]
+}