@tiangong-ai/cli 0.0.51 → 0.0.55

package/dist/data/schemas/core-receipt.v1.json

@@ -0,0 +1,117 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/core-receipt.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "schemaVersion",
+        "cliVersion",
+        "capabilityId",
+        "capabilityVersion",
+        "operationId",
+        "operationVersion",
+        "requestDigest",
+        "manifestDigest",
+        "inputSchemaDigest",
+        "outputSchemaDigest",
+        "inputDigest",
+        "aggregateResponseDigest",
+        "normalizedDataDigest",
+        "observations",
+        "completionStatus",
+        "summary",
+        "generatedAt",
+        "receiptDigest"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.core-receipt.v1" },
+        "cliVersion": { "type": "string", "minLength": 1 },
+        "capabilityId": { "type": "string", "minLength": 1 },
+        "capabilityVersion": { "type": "string", "minLength": 1 },
+        "operationId": { "type": "string", "minLength": 1 },
+        "operationVersion": { "type": "string", "minLength": 1 },
+        "requestDigest": { "$ref": "#/$defs/digest" },
+        "manifestDigest": { "$ref": "#/$defs/nullableDigest" },
+        "inputSchemaDigest": { "$ref": "#/$defs/nullableDigest" },
+        "outputSchemaDigest": { "$ref": "#/$defs/nullableDigest" },
+        "inputDigest": { "$ref": "#/$defs/digest" },
+        "aggregateResponseDigest": { "$ref": "#/$defs/nullableDigest" },
+        "normalizedDataDigest": { "$ref": "#/$defs/nullableDigest" },
+        "observations": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/observation" }
+        },
+        "completionStatus": { "enum": ["success", "partial", "blocked"] },
+        "summary": { "$ref": "#/$defs/summary" },
+        "generatedAt": { "type": "string", "minLength": 1 },
+        "receiptDigest": { "$ref": "#/$defs/digest" }
+    },
+    "$defs": {
+        "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "nullableDigest": {
+            "anyOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }]
+        },
+        "observation": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "observationId",
+                "sourceId",
+                "endpointId",
+                "requestDigest",
+                "responseDigest",
+                "responseBytes",
+                "status",
+                "contentType",
+                "attempts"
+            ],
+            "properties": {
+                "observationId": { "type": "string", "minLength": 1 },
+                "sourceId": { "type": "string", "minLength": 1 },
+                "endpointId": { "type": "string", "minLength": 1 },
+                "requestDigest": { "$ref": "#/$defs/digest" },
+                "responseDigest": { "$ref": "#/$defs/digest" },
+                "responseBytes": { "type": "integer", "minimum": 0 },
+                "status": { "type": "integer", "minimum": 100, "maximum": 599 },
+                "contentType": { "type": "string", "minLength": 1 },
+                "attempts": { "type": "integer", "minimum": 1 }
+            }
+        },
+        "missing": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "identifiers"],
+            "properties": {
+                "kind": { "enum": ["chunk", "field", "file", "page", "range"] },
+                "identifiers": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": { "type": "string", "minLength": 1 }
+                }
+            }
+        },
+        "summary": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "recordCount",
+                "pageCount",
+                "chunkCount",
+                "truncated",
+                "completeness"
+            ],
+            "properties": {
+                "recordCount": { "type": "integer", "minimum": 0 },
+                "pageCount": { "type": "integer", "minimum": 0 },
+                "chunkCount": { "type": "integer", "minimum": 0 },
+                "truncated": { "type": "boolean" },
+                "completeness": { "enum": ["complete", "partial", "blocked"] },
+                "missing": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": { "$ref": "#/$defs/missing" }
+                }
+            }
+        }
+    }
+}

package/dist/data/schemas/describe.v1.json

@@ -0,0 +1,24 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/describe.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["schemaVersion", "manifest", "discovery", "schemas"],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.describe.v1" },
+        "manifest": { "$ref": "https://schemas.tiangong.ai/data/manifest.v1.json" },
+        "discovery": { "$ref": "https://schemas.tiangong.ai/data/discovery.v1.json" },
+        "schemas": {
+            "type": "object",
+            "minProperties": 2,
+            "additionalProperties": {
+                "type": "object",
+                "required": ["$schema", "$id"],
+                "properties": {
+                    "$schema": { "type": "string", "minLength": 1 },
+                    "$id": { "type": "string", "minLength": 1 }
+                }
+            }
+        }
+    }
+}

package/dist/data/schemas/discovery.v1.json

@@ -0,0 +1,130 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/discovery.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "schemaVersion",
+        "capabilityId",
+        "capabilityVersion",
+        "source",
+        "summary",
+        "description",
+        "provides",
+        "doesNotProvide",
+        "selectionHints",
+        "typicalUseCases",
+        "sourceDocumentation",
+        "license",
+        "freshness",
+        "limitations",
+        "operations",
+        "discoveryDigest"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.discovery.v1" },
+        "capabilityId": { "$ref": "#/$defs/id" },
+        "capabilityVersion": { "$ref": "#/$defs/version" },
+        "source": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "providerId",
+                "name",
+                "maintainedBy",
+                "sourceCategory",
+                "summary",
+                "description",
+                "coverage"
+            ],
+            "properties": {
+                "providerId": { "$ref": "#/$defs/id" },
+                "name": { "$ref": "#/$defs/nonEmptyString" },
+                "maintainedBy": { "$ref": "#/$defs/nonEmptyString" },
+                "sourceCategory": { "$ref": "#/$defs/nonEmptyString" },
+                "summary": { "$ref": "#/$defs/nonEmptyString" },
+                "description": { "$ref": "#/$defs/nonEmptyString" },
+                "coverage": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["geographic", "temporal", "granularity"],
+                    "properties": {
+                        "geographic": { "$ref": "#/$defs/nonEmptyString" },
+                        "temporal": { "$ref": "#/$defs/nonEmptyString" },
+                        "granularity": { "$ref": "#/$defs/nonEmptyString" }
+                    }
+                }
+            }
+        },
+        "summary": { "$ref": "#/$defs/nonEmptyString" },
+        "description": { "$ref": "#/$defs/nonEmptyString" },
+        "provides": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "doesNotProvide": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "selectionHints": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "typicalUseCases": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "sourceDocumentation": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["title", "url"],
+                "properties": {
+                    "title": { "$ref": "#/$defs/nonEmptyString" },
+                    "url": { "type": "string", "pattern": "^https://" }
+                }
+            }
+        },
+        "license": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "url", "restrictions"],
+            "properties": {
+                "name": { "$ref": "#/$defs/nonEmptyString" },
+                "url": { "type": "string", "pattern": "^https://" },
+                "restrictions": { "$ref": "#/$defs/nonEmptyStringArray" }
+            }
+        },
+        "freshness": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["kind", "description"],
+            "properties": {
+                "kind": { "$ref": "#/$defs/nonEmptyString" },
+                "description": { "$ref": "#/$defs/nonEmptyString" }
+            }
+        },
+        "limitations": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "operations": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["operationId", "summary", "description"],
+                "properties": {
+                    "operationId": { "$ref": "#/$defs/id" },
+                    "summary": { "$ref": "#/$defs/nonEmptyString" },
+                    "description": { "$ref": "#/$defs/nonEmptyString" }
+                }
+            }
+        },
+        "discoveryDigest": { "$ref": "#/$defs/digest" }
+    },
+    "$defs": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" },
+        "version": {
+            "type": "string",
+            "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$"
+        },
+        "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "nonEmptyString": { "type": "string", "minLength": 1 },
+        "nonEmptyStringArray": {
+            "type": "array",
+            "minItems": 1,
+            "uniqueItems": true,
+            "items": { "$ref": "#/$defs/nonEmptyString" }
+        }
+    }
+}

package/dist/data/schemas/doctor.v1.json

@@ -0,0 +1,40 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/doctor.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "schemaVersion",
+        "capabilityId",
+        "capabilityVersion",
+        "manifestDigest",
+        "mode",
+        "status",
+        "networkAttempted",
+        "checks"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.doctor.v1" },
+        "capabilityId": { "type": "string", "minLength": 1 },
+        "capabilityVersion": { "type": "string", "minLength": 1 },
+        "manifestDigest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "mode": { "enum": ["static", "live"] },
+        "status": { "enum": ["ready", "degraded", "blocked"] },
+        "networkAttempted": { "type": "boolean" },
+        "checks": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["checkId", "status", "message"],
+                "properties": {
+                    "checkId": { "type": "string", "minLength": 1 },
+                    "status": { "enum": ["pass", "warn", "fail"] },
+                    "message": { "type": "string", "minLength": 1 },
+                    "details": { "type": "object" }
+                }
+            }
+        }
+    }
+}

package/dist/data/schemas/error.v1.json

@@ -0,0 +1,48 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/error.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["schemaVersion", "status", "errors"],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.error.v1" },
+        "status": { "const": "blocked" },
+        "errors": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/error" }
+        }
+    },
+    "$defs": {
+        "error": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["code", "message", "retryable", "userActionRequired"],
+            "properties": {
+                "code": {
+                    "enum": [
+                        "invalid-request",
+                        "unsupported-operation",
+                        "incompatible-contract",
+                        "credential-missing",
+                        "credential-invalid",
+                        "provider-auth-blocked",
+                        "endpoint-policy-blocked",
+                        "rate-limited",
+                        "timeout",
+                        "network-failed",
+                        "response-too-large",
+                        "provider-response-invalid",
+                        "normalization-failed",
+                        "partial-result",
+                        "internal-error"
+                    ]
+                },
+                "message": { "type": "string", "minLength": 1 },
+                "retryable": { "type": "boolean" },
+                "userActionRequired": { "type": "boolean" },
+                "details": { "type": "object" }
+            }
+        }
+    }
+}

package/dist/data/schemas/manifest.v1.json

@@ -0,0 +1,174 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/manifest.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "schemaVersion",
+        "capabilityId",
+        "capabilityVersion",
+        "minimumCliVersion",
+        "providerId",
+        "endpoints",
+        "credentials",
+        "limits",
+        "diagnostics",
+        "operations",
+        "manifestDigest"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.manifest.v1" },
+        "capabilityId": { "$ref": "#/$defs/id" },
+        "capabilityVersion": { "$ref": "#/$defs/version" },
+        "minimumCliVersion": { "$ref": "#/$defs/version" },
+        "providerId": { "$ref": "#/$defs/id" },
+        "endpoints": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/endpoint" }
+        },
+        "credentials": {
+            "type": "array",
+            "items": { "$ref": "#/$defs/credential" }
+        },
+        "limits": { "$ref": "#/$defs/limits" },
+        "diagnostics": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["static", "live"],
+            "properties": {
+                "static": { "const": true },
+                "live": { "type": "boolean" }
+            }
+        },
+        "operations": {
+            "type": "array",
+            "minItems": 1,
+            "items": { "$ref": "#/$defs/operation" }
+        },
+        "manifestDigest": { "$ref": "#/$defs/digest" }
+    },
+    "$defs": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" },
+        "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" },
+        "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "stringArray": {
+            "type": "array",
+            "items": { "type": "string", "minLength": 1 },
+            "uniqueItems": true
+        },
+        "limits": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "timeoutMs",
+                "maxRequestBytes",
+                "maxResponseBytes",
+                "maxPages",
+                "maxRecords",
+                "maxRetries",
+                "maxRetryDelayMs",
+                "maxRedirects"
+            ],
+            "properties": {
+                "timeoutMs": { "type": "integer", "minimum": 1 },
+                "maxRequestBytes": { "type": "integer", "minimum": 1 },
+                "maxResponseBytes": { "type": "integer", "minimum": 1 },
+                "maxPages": { "type": "integer", "minimum": 1 },
+                "maxRecords": { "type": "integer", "minimum": 1 },
+                "maxRetries": { "type": "integer", "minimum": 0 },
+                "maxRetryDelayMs": { "type": "integer", "minimum": 0 },
+                "maxRedirects": { "type": "integer", "minimum": 0 }
+            }
+        },
+        "endpoint": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "endpointId",
+                "baseUrl",
+                "pathPrefixes",
+                "allowedMethods",
+                "allowedContentTypes"
+            ],
+            "properties": {
+                "endpointId": { "$ref": "#/$defs/id" },
+                "baseUrl": { "type": "string", "pattern": "^https://" },
+                "pathPrefixes": { "$ref": "#/$defs/stringArray" },
+                "allowedMethods": {
+                    "type": "array",
+                    "items": { "enum": ["GET", "POST"] },
+                    "minItems": 1,
+                    "uniqueItems": true
+                },
+                "allowedContentTypes": { "$ref": "#/$defs/stringArray" }
+            }
+        },
+        "credential": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["credentialId", "environmentVariable", "required", "endpointIds", "injection"],
+            "properties": {
+                "credentialId": { "$ref": "#/$defs/id" },
+                "environmentVariable": { "type": "string", "pattern": "^[A-Z][A-Z0-9_]*$" },
+                "required": { "type": "boolean" },
+                "endpointIds": { "$ref": "#/$defs/stringArray" },
+                "injection": {
+                    "oneOf": [
+                        {
+                            "type": "object",
+                            "additionalProperties": false,
+                            "required": ["kind", "name", "prefix"],
+                            "properties": {
+                                "kind": { "const": "header" },
+                                "name": { "type": "string", "minLength": 1 },
+                                "prefix": { "type": "string" }
+                            }
+                        },
+                        {
+                            "type": "object",
+                            "additionalProperties": false,
+                            "required": ["kind", "placeholder"],
+                            "properties": {
+                                "kind": { "const": "path-segment" },
+                                "placeholder": {
+                                    "type": "string",
+                                    "pattern": "^\\{[a-z][a-z0-9-]*\\}$"
+                                }
+                            }
+                        }
+                    ]
+                }
+            }
+        },
+        "schemaRef": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["schemaId", "digest"],
+            "properties": {
+                "schemaId": { "type": "string", "minLength": 1 },
+                "digest": { "$ref": "#/$defs/digest" }
+            }
+        },
+        "operation": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["operationId", "operationVersion", "inputSchema", "outputSchema", "limits"],
+            "properties": {
+                "operationId": { "$ref": "#/$defs/id" },
+                "operationVersion": { "$ref": "#/$defs/version" },
+                "inputSchema": { "$ref": "#/$defs/schemaRef" },
+                "outputSchema": { "$ref": "#/$defs/schemaRef" },
+                "limits": { "$ref": "#/$defs/limits" },
+                "artifactOutput": {
+                    "type": "object",
+                    "additionalProperties": false,
+                    "required": ["kind", "required"],
+                    "properties": {
+                        "kind": { "const": "directory" },
+                        "required": { "const": true }
+                    }
+                }
+            }
+        }
+    }
+}

package/dist/data/schemas/run-request.v1.json

@@ -0,0 +1,37 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/run-request.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "schemaVersion",
+        "capabilityId",
+        "capabilityVersion",
+        "operationId",
+        "operationVersion",
+        "input"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.run-request.v1" },
+        "capabilityId": { "$ref": "#/$defs/id" },
+        "capabilityVersion": { "$ref": "#/$defs/version" },
+        "operationId": { "$ref": "#/$defs/id" },
+        "operationVersion": { "$ref": "#/$defs/version" },
+        "input": {},
+        "requestId": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "limits": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "timeoutMs": { "type": "integer", "minimum": 1 },
+                "maxResponseBytes": { "type": "integer", "minimum": 1 },
+                "maxPages": { "type": "integer", "minimum": 1 },
+                "maxRecords": { "type": "integer", "minimum": 1 }
+            }
+        }
+    },
+    "$defs": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[._-][a-z0-9]+)*$" },
+        "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:[-+][0-9A-Za-z.-]+)?$" }
+    }
+}

package/dist/data/schemas/run-result.v1.json

@@ -0,0 +1,77 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://schemas.tiangong.ai/data/run-result.v1.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "schemaVersion",
+        "status",
+        "requestId",
+        "contract",
+        "data",
+        "summary",
+        "warnings",
+        "errors",
+        "receipt"
+    ],
+    "properties": {
+        "schemaVersion": { "const": "tiangong.data.run-result.v1" },
+        "status": { "enum": ["success", "partial", "blocked"] },
+        "requestId": { "type": ["string", "null"] },
+        "contract": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "cliVersion",
+                "capabilityId",
+                "capabilityVersion",
+                "operationId",
+                "operationVersion",
+                "manifestDigest",
+                "inputSchema",
+                "outputSchema"
+            ],
+            "properties": {
+                "cliVersion": { "type": "string", "minLength": 1 },
+                "capabilityId": { "type": "string", "minLength": 1 },
+                "capabilityVersion": { "type": "string", "minLength": 1 },
+                "operationId": { "type": "string", "minLength": 1 },
+                "operationVersion": { "type": "string", "minLength": 1 },
+                "manifestDigest": { "$ref": "#/$defs/nullableDigest" },
+                "inputSchema": { "$ref": "#/$defs/nullableSchemaRef" },
+                "outputSchema": { "$ref": "#/$defs/nullableSchemaRef" }
+            }
+        },
+        "data": {},
+        "summary": {
+            "$ref": "https://schemas.tiangong.ai/data/core-receipt.v1.json#/$defs/summary"
+        },
+        "warnings": {
+            "type": "array",
+            "items": { "type": "string" }
+        },
+        "errors": {
+            "type": "array",
+            "items": { "$ref": "https://schemas.tiangong.ai/data/error.v1.json#/$defs/error" }
+        },
+        "receipt": { "$ref": "https://schemas.tiangong.ai/data/core-receipt.v1.json" }
+    },
+    "$defs": {
+        "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "nullableDigest": {
+            "anyOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }]
+        },
+        "schemaRef": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["schemaId", "digest"],
+            "properties": {
+                "schemaId": { "type": "string", "minLength": 1 },
+                "digest": { "$ref": "#/$defs/digest" }
+            }
+        },
+        "nullableSchemaRef": {
+            "anyOf": [{ "$ref": "#/$defs/schemaRef" }, { "type": "null" }]
+        }
+    }
+}