@oddkin/ai 0.0.0-stage → 1.0.0-beta.0

package/schemas/oddkin.ai.tool-call.v1.schema.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://oddkin.dev/schemas/ai/oddkin.ai.tool-call.v1.schema.json",
+  "title": "oddkin.ai.tool-call",
+  "type": "object",
+  "properties": {
+    "toolCallId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "attemptId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "toolName": {
+      "type": "string",
+      "minLength": 1
+    },
+    "title": {
+      "description": "Human-readable tool name.",
+      "type": "string"
+    },
+    "purpose": {
+      "description": "Why the tool is being used.",
+      "type": "string"
+    },
+    "status": {
+      "description": "Argument generation, approval, and execution are separate states.",
+      "enum": [
+        "input-streaming",
+        "input-available",
+        "awaiting-approval",
+        "executing",
+        "output-available",
+        "output-error",
+        "denied",
+        "cancelled"
+      ]
+    },
+    "inputText": {
+      "description": "Streamed argument text, possibly partial.",
+      "type": "string"
+    },
+    "input": {
+      "description": "Complete arguments."
+    },
+    "output": {
+      "description": "Result; untrusted."
+    },
+    "error": {
+      "description": "An error safe to show to users. Diagnostic details stay in host logs.",
+      "type": "object",
+      "properties": {
+        "code": {
+          "description": "Stable application-defined code.",
+          "type": "string",
+          "minLength": 1
+        },
+        "message": {
+          "description": "User-presentable message, localized by the host.",
+          "type": "string"
+        },
+        "retryable": {
+          "description": "Whether retrying the same operation may succeed.",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "code",
+        "message"
+      ]
+    },
+    "approvalId": {
+      "type": "string",
+      "minLength": 1
+    },
+    "retryable": {
+      "description": "The host can retry this tool call.",
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "toolCallId",
+    "toolName",
+    "status"
+  ]
+}

package/schemas/oddkin.ai.transcript-segment.v1.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://oddkin.dev/schemas/ai/oddkin.ai.transcript-segment.v1.schema.json",
+  "title": "oddkin.ai.transcript-segment",
+  "type": "object",
+  "properties": {
+    "id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "text": {
+      "type": "string"
+    },
+    "final": {
+      "description": "Interim text may still change.",
+      "type": "boolean"
+    },
+    "speaker": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "text",
+    "final"
+  ]
+}

package/schemas/oddkin.ai.usage.v1.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://oddkin.dev/schemas/ai/oddkin.ai.usage.v1.schema.json",
+  "title": "oddkin.ai.usage",
+  "type": "array",
+  "items": {
+    "type": "object",
+    "properties": {
+      "kind": {
+        "enum": [
+          "input-tokens",
+          "output-tokens",
+          "context",
+          "quota",
+          "cost",
+          "other"
+        ]
+      },
+      "label": {
+        "type": "string",
+        "minLength": 1
+      },
+      "used": {
+        "type": "number",
+        "minimum": 0
+      },
+      "limit": {
+        "type": "number",
+        "minimum": 0
+      },
+      "unit": {
+        "description": "tokens, requests, … (cost uses currency).",
+        "type": "string"
+      },
+      "currency": {
+        "description": "ISO 4217.",
+        "type": "string",
+        "pattern": "^[A-Z]{3}$"
+      },
+      "precision": {
+        "description": "Supplied by the host; never inferred.",
+        "enum": [
+          "measured",
+          "estimated",
+          "unknown"
+        ]
+      }
+    },
+    "required": [
+      "kind",
+      "label",
+      "precision"
+    ]
+  }
+}