@irogane/kaji 0.2.0-beta.11

package/contracts/feature-tiers-v1.json

@@ -0,0 +1,488 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kaji.dev/contracts/feature-tiers-v1.json",
+  "contractVersion": "1.0.0",
+  "cliCommands": {
+    "python": {
+      "stable": ["add", "connect", "disconnect", "init", "list-integrations"],
+      "experimental": ["doctor", "gen", "info", "secret", "upgrade"]
+    },
+    "typescript": {
+      "stable": ["add", "connect", "disconnect", "init", "list-integrations", "replay"],
+      "experimental": []
+    }
+  },
+  "packageSubpaths": {
+    "typescript": {
+      "./anthropic": {
+        "tier": "experimental",
+        "exports": ["AnthropicProvider", "AnthropicProviderOptions"]
+      },
+      "./auth": {
+        "tier": "experimental",
+        "exports": [
+          "GoogleOAuthClient",
+          "GoogleOAuthClientOptions",
+          "MacOSKeychainTokenStorage",
+          "OAuthAccessTokenProvider",
+          "OAuthCredentialRecord",
+          "OAuthTokenSet",
+          "OAuthTokenStorage",
+          "canonicalOAuthCredentialJson",
+          "snapshotOAuthCredentialRecord"
+        ]
+      },
+      "./cli": {
+        "tier": "stable",
+        "exports": []
+      },
+      "./integrations": {
+        "tier": "experimental",
+        "exports": [
+          "BoundedResponse",
+          "FixedOriginRequester",
+          "INTEGRATION_RECOVERY",
+          "IntegrationAuthRequiredError",
+          "IntegrationExecutionError",
+          "IntegrationPolicyError",
+          "IntegrationRateLimitedError",
+          "IntegrationRecoveryFields",
+          "IntegrationRecoveryReason",
+          "IntegrationTransientReadError",
+          "closedRecoveryFields",
+          "createGitHubRequester",
+          "createGmailRequester",
+          "snapshotIntegrationResult"
+        ]
+      },
+      "./integrations/github": {
+        "tier": "experimental",
+        "exports": [
+          "CreateGitHubIntegrationOptions",
+          "GitHubIntegration",
+          "createGithubIntegration",
+          "inspectIntegration"
+        ]
+      },
+      "./openai": {
+        "tier": "stable",
+        "exports": ["OpenAIProvider", "OpenAIProviderOptions", "RetryOptions"]
+      },
+      "./testing": {
+        "tier": "experimental",
+        "exports": [
+          "MockProvider",
+          "ProviderResponseDiagnostics",
+          "createSessionState",
+          "withProviderResponseDiagnostics"
+        ]
+      }
+    }
+  },
+  "publicExports": {
+    "python": {
+      "stable": [
+        "AgentBuilder",
+        "AgentRuntime",
+        "ApprovalDecision",
+        "ApprovalHandler",
+        "ApprovalRequestContext",
+        "CancellationToken",
+        "Clock",
+        "DurableJsonLimitError",
+        "EffectiveRuntimeLimits",
+        "EventApprovalHandler",
+        "EventBackedApprovalHandler",
+        "EventBufferOverflowError",
+        "EventDeliveryError",
+        "EventIdConflictError",
+        "EventJournal",
+        "EventStore",
+        "EventStoreCapacityError",
+        "IdFactory",
+        "IdempotencyCapacityExceeded",
+        "IdempotencyConflictError",
+        "InMemoryEventJournal",
+        "InMemoryEventStore",
+        "InMemorySessionStore",
+        "InMemoryToolIdempotencyLedger",
+        "InMemoryTurnCoordinator",
+        "Integration",
+        "InvalidDurableValueError",
+        "Measurement",
+        "MetricsSink",
+        "MissingToolIdentityError",
+        "ModelProvider",
+        "NOOP_METRICS",
+        "NOOP_TRACE",
+        "NewKajiEvent",
+        "NormalizedProviderError",
+        "ProviderAPIError",
+        "ProviderCancellationContractViolation",
+        "ProviderConfigError",
+        "ProviderConnectionError",
+        "ProviderError",
+        "ProviderOutputLimitError",
+        "ProviderRateLimitedError",
+        "ProviderResponseLimits",
+        "PurgeableEventStore",
+        "SessionManager",
+        "SessionPurgeBusyError",
+        "SessionPurgeUnsupportedError",
+        "SessionRecord",
+        "SessionState",
+        "SessionStore",
+        "SpanHandle",
+        "StoredKajiEvent",
+        "SystemClock",
+        "SystemIdFactory",
+        "ToolArgumentValidationError",
+        "ToolExecutionContext",
+        "ToolExecutionController",
+        "ToolExecutionError",
+        "ToolExecutionLimits",
+        "ToolIdempotencyLedger",
+        "ToolInvocation",
+        "ToolRegistry",
+        "ToolSchemaValidationError",
+        "ToolSchemaValidator",
+        "ToolSpec",
+        "TraceSink",
+        "TurnContext",
+        "TurnCoordinator",
+        "TurnExecutionLimits",
+        "TurnResult",
+        "TurnTimeoutError",
+        "UnclassifiedToolRiskError",
+        "UnknownToolError",
+        "UserMessage",
+        "__version__",
+        "build_tools_payload",
+        "function_tool",
+        "get_provider",
+        "list_tool_specs",
+        "normalize_provider_error",
+        "register_provider",
+        "register_tool",
+        "replay_session",
+        "spec_to_neutral",
+        "supports_session_purge",
+        "to_openai",
+        "tool"
+      ],
+      "experimental": [
+        "AppendResult",
+        "Chunk",
+        "CredentialStore",
+        "DisconnectResult",
+        "Document",
+        "DocumentRAG",
+        "Embedder",
+        "EmbeddingCache",
+        "EventBus",
+        "GoogleOAuthClient",
+        "HistoryStore",
+        "InMemoryEventBus",
+        "InMemoryHistoryStore",
+        "InMemoryVectorStore",
+        "JournalEventEmitter",
+        "MacOSKeychainTokenStorage",
+        "OAuthCredentialRecord",
+        "OAuthTokenSet",
+        "SplitEventJournal",
+        "ToolRetriever",
+        "VectorStore",
+        "to_anthropic",
+        "to_gemini"
+      ],
+      "deprecated": []
+    },
+    "typescript": {
+      "stable": [
+        "AgentBuilder",
+        "AgentBuilderBuildOptions",
+        "AgentRuntime",
+        "AgentRuntimeOptions",
+        "AgentStrategy",
+        "AgentTurnFailed",
+        "ApprovalDeadlineSource",
+        "ApprovalDecision",
+        "ApprovalFailureCode",
+        "ApprovalKey",
+        "ApprovalRejectionCode",
+        "ApprovalRequestContext",
+        "AutoApprovalHandler",
+        "AutoApprovalPolicy",
+        "BaseEvent",
+        "BoundTool",
+        "BoundedResponse",
+        "CancellationError",
+        "CancellationToken",
+        "CancellationTokenLike",
+        "CliApprovalInput",
+        "CliApprovalOptions",
+        "CliApprovalOutput",
+        "Clock",
+        "ContextDiagnostics",
+        "ContextIntegrityError",
+        "ContextWindow",
+        "ContextWindowOverflowError",
+        "DEFAULT_CONTEXT_WINDOW",
+        "DEFAULT_PROVIDER_RESPONSE_LIMITS",
+        "DEFAULT_TOOL_EXECUTION_LIMITS",
+        "DEFAULT_TURN_EXECUTION_LIMITS",
+        "DurableJsonLimitError",
+        "EffectiveRuntimeLimits",
+        "EnvSecretSource",
+        "EventApprovalHandler",
+        "EventApprovalHandlerOptions",
+        "EventBackedApprovalHandler",
+        "EventBufferOverflowError",
+        "EventBusProtocol",
+        "EventCommitter",
+        "EventDeliveryError",
+        "EventIdConflictError",
+        "EventSchemaIncompatibleError",
+        "EventStore",
+        "EventStoreCapacityError",
+        "EventType",
+        "FunctionToolHandler",
+        "FunctionToolMeta",
+        "GenerateTextOptions",
+        "IdFactory",
+        "IdScope",
+        "IdempotencyCapacityError",
+        "IdempotencyConflictError",
+        "InMemoryEventCommitter",
+        "InMemoryEventCommitterOptions",
+        "InMemoryEventStore",
+        "InMemorySessionStore",
+        "InMemorySessionTurnCoordinator",
+        "InMemoryToolIdempotencyLedger",
+        "InMemoryToolIdempotencyLedgerOptions",
+        "IndexValidationError",
+        "Integrable",
+        "Integration",
+        "IntegrationAuth",
+        "IntegrationExperimentalError",
+        "IntegrationManifestDocument",
+        "IntegrationManifestTool",
+        "IntegrationNotFoundError",
+        "IntegrationRuntime",
+        "IntegrationStability",
+        "IntegrationToolRisk",
+        "IntegrationValidationCode",
+        "IntegrationValidationError",
+        "InvalidDurableValueError",
+        "JSONSchema",
+        "JournalStage",
+        "KajiEvent",
+        "KajiEventInput",
+        "ListToolSpecsOptions",
+        "LoadedIntegrationManifest",
+        "METRIC_NAMES",
+        "ManifestValidationError",
+        "Message",
+        "MetricLabels",
+        "MetricMeasurement",
+        "MetricName",
+        "MetricsSink",
+        "MissingToolIdentityError",
+        "ModelCostEntry",
+        "ModelProvider",
+        "ModelProviderOptions",
+        "ModelResponse",
+        "ModelResponseChunk",
+        "NOOP_METRICS",
+        "NOOP_TRACE",
+        "NewKajiEvent",
+        "NormalizedIntegrationValidationError",
+        "NormalizedProviderError",
+        "ObservableCancellationToken",
+        "OpenAIProvider",
+        "OpenAIProviderOptions",
+        "ProviderAPIError",
+        "ProviderCancellationContractViolation",
+        "ProviderConfigError",
+        "ProviderConnectionError",
+        "ProviderError",
+        "ProviderFamily",
+        "ProviderMessage",
+        "ProviderOutputDimension",
+        "ProviderOutputLimitError",
+        "ProviderRateLimitedError",
+        "ProviderResponseLimits",
+        "ProviderStatus",
+        "PurgeableEventStore",
+        "RegistryIndexDocument",
+        "RegistryIndexEntry",
+        "RegistryLoaderOptions",
+        "RetryOptions",
+        "RunTurnOptions",
+        "SecretSource",
+        "SessionCreated",
+        "SessionManager",
+        "SessionProjector",
+        "SessionPurgeBusyError",
+        "SessionPurgeUnsupportedError",
+        "SessionRecord",
+        "SessionState",
+        "SessionStore",
+        "SessionTokens",
+        "SessionTurnCoordinator",
+        "SessionTurnLease",
+        "SpanName",
+        "StoredKajiEvent",
+        "StreamTextResult",
+        "SubscriberStage",
+        "TimerHandle",
+        "TimerScheduler",
+        "TokenUsage",
+        "ToolArgumentValidationError",
+        "ToolCall",
+        "ToolCallInstruction",
+        "ToolCallResult",
+        "ToolClaimResult",
+        "ToolExecutionContext",
+        "ToolExecutionController",
+        "ToolExecutionControllerOptions",
+        "ToolExecutionControllerOutcome",
+        "ToolExecutionError",
+        "ToolExecutionLimits",
+        "ToolExecutionOutcome",
+        "ToolExecutionRequest",
+        "ToolExecutor",
+        "ToolFailureFields",
+        "ToolFailureOutcome",
+        "ToolHandler",
+        "ToolIdempotencyClaim",
+        "ToolIdempotencyLedger",
+        "ToolLedgerOutcome",
+        "ToolMetricOutcome",
+        "ToolParameters",
+        "ToolPlanner",
+        "ToolPlannerOptions",
+        "ToolPolicy",
+        "ToolPolicyOptions",
+        "ToolPolicyViolation",
+        "ToolRegistry",
+        "ToolRisk",
+        "ToolSchemaValidationError",
+        "ToolSchemaValidator",
+        "ToolSpec",
+        "ToolValidationCode",
+        "ToolValidationError",
+        "TraceAttributeName",
+        "TraceAttributeValue",
+        "TraceAttributes",
+        "TraceSink",
+        "TraceSpan",
+        "TurnAccounting",
+        "TurnContext",
+        "TurnDeadlineOutcome",
+        "TurnExecutionLimits",
+        "TurnLeaseOptions",
+        "TurnOptions",
+        "TurnOutcome",
+        "TurnPhase",
+        "TurnResult",
+        "TurnTimeoutError",
+        "TypedApprovalHandler",
+        "UnclassifiedToolRiskError",
+        "UnknownToolError",
+        "UuidFactory",
+        "VERSION",
+        "applyEvent",
+        "approvalKey",
+        "calculateCostUsd",
+        "cliApprovalHandler",
+        "deadlineAfter",
+        "executeTool",
+        "formatIntegrationError",
+        "functionTool",
+        "generateText",
+        "getProvider",
+        "listToolSpecs",
+        "loadManifest",
+        "loadRegistryIndex",
+        "lookupCost",
+        "normalizeProviderError",
+        "openai",
+        "providerFamily",
+        "recordMetric",
+        "registerProvider",
+        "registerTool",
+        "replaySession",
+        "resolveProviderResponseLimits",
+        "startSpan",
+        "streamText",
+        "supportsSessionPurge",
+        "throwIfCancellationRequested",
+        "tool",
+        "toolSpecFromSchema",
+        "validateIndexDocument",
+        "validateManifestDocument",
+        "validateNewEvent",
+        "validateStoredEvent"
+      ],
+      "experimental": [
+        "AnthropicProvider",
+        "AnthropicProviderOptions",
+        "BoundNetworkTransport",
+        "EventBus",
+        "GeminiFactoryOptions",
+        "OpenRouterFactoryOptions",
+        "SafeFetchPolicy",
+        "SplitEventCommitter",
+        "SplitEventCommitterOptions",
+        "anthropic",
+        "gemini",
+        "kimi",
+        "openrouter",
+        "safeRequest"
+      ],
+      "deprecated": []
+    }
+  },
+  "stable": [
+    { "id": "agent-builder", "surface": "Agent builder" },
+    { "id": "runtime-turn-loop", "surface": "Runtime turn loop" },
+    { "id": "cancellation", "surface": "Cancellation" },
+    { "id": "sessions", "surface": "Sessions" },
+    {
+      "id": "in-memory-event-store-journal",
+      "surface": "In-memory event store/journal"
+    },
+    { "id": "event-replay", "surface": "Event replay" },
+    {
+      "id": "tool-registry-planner-policy",
+      "surface": "Tool registry/planner/policy"
+    },
+    { "id": "openai-adapter", "surface": "OpenAI adapter" },
+    { "id": "echo-integration", "surface": "Echo integration" }
+  ],
+  "experimental": [
+    {
+      "id": "python-redis-event-history",
+      "surface": "Python-only Redis event/history backends"
+    },
+    { "id": "voice-tts", "surface": "Voice/TTS" },
+    { "id": "rag-retrieval", "surface": "RAG/retrieval" },
+    { "id": "native-gemini-kimi", "surface": "Native Gemini/Kimi" },
+    { "id": "anthropic-adapter", "surface": "Anthropic adapter" },
+    { "id": "retriever-selection", "surface": "Retriever selection" },
+    {
+      "id": "distributed-session-serialization",
+      "surface": "Distributed same-session serialization"
+    },
+    {
+      "id": "exactly-once-external-side-effects",
+      "surface": "Exactly-once external side effects"
+    },
+    {
+      "id": "unbounded-cross-process-replay",
+      "surface": "Unbounded or cross-process replay"
+    },
+    { "id": "durable-snapshotting", "surface": "Durable snapshotting" }
+  ]
+}

package/contracts/integrations/abi-index-v1.json

@@ -0,0 +1,8 @@
+{
+  "schemaVersion": "1.0.0",
+  "integrations": {
+    "echo": "echo-tool-abi-v1.json",
+    "gmail": "gmail-tool-abi-v1.json",
+    "github": "github-tool-abi-v1.json"
+  }
+}