@inneranimalmedia/agentsam-sdk 2.5.0 → 2.6.1

package/protocol/models/model-inventory-v2.schema.json

@@ -0,0 +1,212 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://inneranimalmedia.com/protocol/models/model-inventory-v2.schema.json",
+  "title": "AgentSam Model Inventory v2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "generatedAt", "providers", "models"],
+  "properties": {
+    "schemaVersion": {
+      "const": "agentsam-model-inventory-v2"
+    },
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "selection": {
+      "oneOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/selection" }
+      ]
+    },
+    "providers": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/provider" }
+    },
+    "models": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/model" }
+    }
+  },
+  "$defs": {
+    "provenance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sourceKind"],
+      "properties": {
+        "sourceKind": {
+          "enum": [
+            "provider_api",
+            "provider_published",
+            "local_runtime",
+            "agentsam_policy",
+            "unknown"
+          ]
+        },
+        "sourceRef": { "type": ["string", "null"] },
+        "observedAt": { "type": ["string", "null"], "format": "date-time" },
+        "pricingAsOf": { "type": ["string", "null"] },
+        "status": {
+          "enum": ["current", "stale", "unavailable", "unknown"]
+        }
+      }
+    },
+    "provider": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "label", "configured", "secretHidden"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "configured": { "type": "boolean" },
+        "present": { "type": ["boolean", "null"] },
+        "valid": { "type": ["boolean", "null"] },
+        "authorized": { "type": ["boolean", "null"] },
+        "credentialSourceClass": { "type": ["string", "null"] },
+        "credentialPath": { "type": ["string", "null"] },
+        "verifiedAt": { "type": ["string", "null"], "format": "date-time" },
+        "modelsDiscovered": { "type": ["integer", "null"], "minimum": 0 },
+        "secretHidden": { "const": true },
+        "error": { "type": ["string", "null"] }
+      }
+    },
+    "priceSet": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "input": { "type": ["number", "null"], "minimum": 0 },
+        "cachedInput": { "type": ["number", "null"], "minimum": 0 },
+        "cacheWrite": { "type": ["number", "null"], "minimum": 0 },
+        "output": { "type": ["number", "null"], "minimum": 0 }
+      }
+    },
+    "pricing": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["currency", "unit", "provenance"],
+      "properties": {
+        "currency": { "type": "string", "minLength": 1 },
+        "unit": { "type": "string", "minLength": 1 },
+        "standard": { "$ref": "#/$defs/priceSet" },
+        "fast": { "$ref": "#/$defs/priceSet" },
+        "flex": { "$ref": "#/$defs/priceSet" },
+        "batch": { "$ref": "#/$defs/priceSet" },
+        "rules": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        },
+        "provenance": { "$ref": "#/$defs/provenance" }
+      }
+    },
+    "providerCapabilities": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "contextTokens": { "type": ["integer", "null"], "minimum": 1 },
+        "maxOutputTokens": { "type": ["integer", "null"], "minimum": 1 },
+        "reasoningEfforts": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true
+        },
+        "serviceTiers": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true
+        },
+        "modalities": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true
+        },
+        "tools": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true
+        }
+      }
+    },
+    "runtimeCompatibility": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "interactive": { "type": ["boolean", "null"] },
+        "functionCalling": { "type": ["boolean", "null"] },
+        "vision": { "type": ["boolean", "null"] },
+        "toolLoop": { "type": ["boolean", "null"] },
+        "notes": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "agentsamPolicy": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "recommended": { "type": "boolean" },
+        "rank": { "type": ["integer", "null"], "minimum": 1 },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "uniqueItems": true
+        },
+        "workingContextTarget": { "type": ["integer", "null"], "minimum": 1 },
+        "compactAt": { "type": ["integer", "null"], "minimum": 1 },
+        "interveneAt": { "type": ["integer", "null"], "minimum": 1 }
+      }
+    },
+    "model": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "provider",
+        "modelId",
+        "available",
+        "providerCapabilities",
+        "runtimeCompatibility",
+        "provenance",
+        "agentsam"
+      ],
+      "properties": {
+        "provider": { "type": "string", "minLength": 1 },
+        "modelId": { "type": "string", "minLength": 1 },
+        "label": { "type": ["string", "null"] },
+        "available": { "type": "boolean" },
+        "providerCapabilities": { "$ref": "#/$defs/providerCapabilities" },
+        "runtimeCompatibility": { "$ref": "#/$defs/runtimeCompatibility" },
+        "pricing": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/pricing" }
+          ]
+        },
+        "provenance": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["availability", "capabilities"],
+          "properties": {
+            "availability": { "$ref": "#/$defs/provenance" },
+            "capabilities": { "$ref": "#/$defs/provenance" }
+          }
+        },
+        "agentsam": { "$ref": "#/$defs/agentsamPolicy" }
+      }
+    },
+    "selection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider", "modelId"],
+      "properties": {
+        "provider": { "type": "string", "minLength": 1 },
+        "modelId": { "type": "string", "minLength": 1 },
+        "reasoningEffort": { "type": ["string", "null"] },
+        "serviceTier": { "type": ["string", "null"] },
+        "selectedAt": { "type": ["string", "null"], "format": "date-time" }
+      }
+    }
+  }
+}

package/protocol/repository/repository-contract.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/repository/repository-contract.schema.json",
+  "title": "AgentSam Repository Contract Record",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "id", "account_id", "repository_id", "contract_key", "contract_version", "contract_type", "name", "contract_hash", "status"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "account_id": { "type": "string", "minLength": 1 },
+    "repository_id": { "type": "string", "minLength": 1 },
+    "contract_key": { "type": "string", "minLength": 1 },
+    "contract_version": { "type": "string", "minLength": 1 },
+    "contract_type": { "enum": ["api", "schema", "runtime", "cli", "event", "receipt", "package"] },
+    "name": { "type": "string", "minLength": 1 },
+    "description": { "type": ["string", "null"] },
+    "manifest_path": { "type": ["string", "null"] },
+    "contract_hash": { "type": "string", "minLength": 1 },
+    "status": { "enum": ["active", "deprecated", "retired"] },
+    "created_at": { "type": ["integer", "null"], "minimum": 0 },
+    "updated_at": { "type": ["integer", "null"], "minimum": 0 }
+  }
+}

package/protocol/repository/repository-dependency.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/repository/repository-dependency.schema.json",
+  "title": "AgentSam Repository Dependency Record",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "id", "account_id", "source_repository_id", "target_repository_id", "dependency_type", "criticality", "failure_policy"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "id": { "type": "string", "minLength": 1 },
+    "account_id": { "type": "string", "minLength": 1 },
+    "source_repository_id": { "type": "string", "minLength": 1 },
+    "target_repository_id": { "type": "string", "minLength": 1 },
+    "dependency_type": { "enum": ["runtime", "build", "contract", "package", "deploy", "tool", "data"] },
+    "contract_id": { "type": ["string", "null"] },
+    "criticality": { "enum": ["informational", "compatible", "strict", "critical"] },
+    "required_version": { "type": ["string", "null"] },
+    "required_contract_hash": { "type": ["string", "null"] },
+    "failure_policy": { "enum": ["warn", "block_certification", "block_deploy", "degrade"] },
+    "description": { "type": ["string", "null"] },
+    "created_at": { "type": ["integer", "null"], "minimum": 0 },
+    "updated_at": { "type": ["integer", "null"], "minimum": 0 }
+  }
+}

package/protocol/repository/repository-identity.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/repository/repository-identity.schema.json",
+  "title": "AgentSam Repository Identity",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "repository_id", "full_name", "role", "default_branch", "status"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "repository_id": { "type": "string", "minLength": 1 },
+    "full_name": { "type": "string", "minLength": 1 },
+    "role": { "type": "string", "minLength": 1 },
+    "default_branch": { "type": "string", "minLength": 1 },
+    "canonical_url": { "type": ["string", "null"] },
+    "status": { "enum": ["active", "archived", "disabled"] }
+  }
+}

package/protocol/rpc/v1/common.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+
+package agentsam.knowledge.v1;
+
+message JobId {
+  string value = 1;
+}
+
+message RepositoryRef {
+  string alias = 1;
+  string repository_id = 2;
+}
+
+message StringList {
+  repeated string values = 1;
+}

package/protocol/rpc/v1/errors.proto

@@ -0,0 +1,35 @@
+syntax = "proto3";
+
+package agentsam.knowledge.v1;
+
+// Numeric values intentionally match google.rpc.Code / gRPC canonical status codes.
+enum ErrorCode {
+  ERROR_CODE_OK = 0;
+  ERROR_CODE_CANCELLED = 1;
+  ERROR_CODE_UNKNOWN = 2;
+  ERROR_CODE_INVALID_ARGUMENT = 3;
+  ERROR_CODE_DEADLINE_EXCEEDED = 4;
+  ERROR_CODE_NOT_FOUND = 5;
+  ERROR_CODE_ALREADY_EXISTS = 6;
+  ERROR_CODE_PERMISSION_DENIED = 7;
+  ERROR_CODE_RESOURCE_EXHAUSTED = 8;
+  ERROR_CODE_FAILED_PRECONDITION = 9;
+  ERROR_CODE_ABORTED = 10;
+  ERROR_CODE_OUT_OF_RANGE = 11;
+  ERROR_CODE_UNIMPLEMENTED = 12;
+  ERROR_CODE_INTERNAL = 13;
+  ERROR_CODE_UNAVAILABLE = 14;
+  ERROR_CODE_DATA_LOSS = 15;
+  ERROR_CODE_UNAUTHENTICATED = 16;
+}
+
+message ErrorDetail {
+  ErrorCode code = 1;
+  string message = 2;
+  bool retryable = 3;
+  string reason = 4;
+  optional uint32 http_status = 5;
+  optional uint32 retry_after_ms = 6;
+  optional string provider = 7;
+  optional string provider_code = 8;
+}

package/protocol/rpc/v1/knowledge.proto

@@ -0,0 +1,77 @@
+syntax = "proto3";
+
+package agentsam.knowledge.v1;
+
+import "google/protobuf/timestamp.proto";
+import "common.proto";
+import "errors.proto";
+
+service KnowledgeService {
+  rpc ListRepositories(ListRepositoriesRequest) returns (ListRepositoriesResponse);
+  rpc SubmitJob(SubmitJobRequest) returns (Job);
+  rpc GetJob(GetJobRequest) returns (Job);
+  rpc WatchJob(WatchJobRequest) returns (stream JobEvent);
+}
+
+message ListRepositoriesRequest {}
+
+message ListRepositoriesResponse {
+  repeated RepositoryRef repositories = 1;
+  bool embeddings_enabled = 2;
+}
+
+enum JobOperation {
+  JOB_OPERATION_UNSPECIFIED = 0;
+  JOB_OPERATION_INDEX = 1;
+  JOB_OPERATION_PLAN = 2;
+  JOB_OPERATION_SEARCH = 3;
+}
+
+enum JobStatus {
+  JOB_STATUS_UNSPECIFIED = 0;
+  JOB_STATUS_QUEUED = 1;
+  JOB_STATUS_RUNNING = 2;
+  JOB_STATUS_COMPLETED = 3;
+  JOB_STATUS_FAILED = 4;
+}
+
+message SubmitJobRequest {
+  string repository = 1;
+  JobOperation operation = 2;
+  optional string scope = 3;
+  StringList include = 4;
+  StringList exclude = 5;
+  optional bool embed = 6;
+  optional bool semantic = 7;
+  optional string query = 8;
+  optional uint32 top_k = 9;
+  optional uint32 token_budget = 10;
+  optional string generation_id = 11;
+  optional uint32 max_inputs = 12;
+  optional uint32 max_characters = 13;
+  optional string idempotency_key = 14;
+}
+
+message GetJobRequest {
+  JobId job_id = 1;
+}
+
+message WatchJobRequest {
+  JobId job_id = 1;
+}
+
+message Job {
+  JobId id = 1;
+  JobStatus status = 2;
+  uint32 attempts = 3;
+  google.protobuf.Timestamp created_at = 4;
+  google.protobuf.Timestamp updated_at = 5;
+  string result_json = 6;
+  ErrorDetail failure = 7;
+}
+
+message JobEvent {
+  Job job = 1;
+  google.protobuf.Timestamp observed_at = 2;
+  uint64 sequence = 3;
+}