prescient 0.6.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 167f50351b78b35d1ae63d3487285db48c07799ad015b5d49f46dd3c451afa49
-  data.tar.gz: 91e1895635015120c75b0b461fea017d8ec7c4b5ebd81f1d2b0c86ba37690e1d
+  metadata.gz: e272a00a9f7baaee44c4ad7b9827da6c1e5b930a98228e8d58718474d3090214
+  data.tar.gz: a7ac75b948c326d0829db56e0ab297561d178fa4643a6a4bbd5b4dc11cff150b
 SHA512:
-  metadata.gz: 6cdf4ed9b05525692898cdd88153f092c23f5caac1d422962bdc768055bb225e960e45a9fb877adb17a7c686e8bf608db09dea1b3e24ebc15767071255910285
-  data.tar.gz: ecec27b8c215dfe5fb92e00f68fd6a5ae66c8284342525c9ae635214318032fc4970a72d2944679e455915f2ba8de8425a07706530ca6c309bedc5d5d4ff114a
+  metadata.gz: 1e4ff77f5dd524e7bc3217b4f8fc1b8045f43d188b751f81dc2964dcf2d15dbfd3ed58efe8598ba40bd875e19a3597de1308e32c066466713b06af8e79fea55a
+  data.tar.gz: 3f5f8e5f78bc8db0566102f686ce1b66e752f9f81faba9dae09adfa49883aaa67c621b108b9a60cb573d695cae4874567e2ebf1c69b90a3971a6686f0316c288

data/.rubocop.yml

@@ -25,7 +25,8 @@ AllCops:
     - 'Rakefile'
     - 'examples/**/*'
 
-# === LAYOUT & FORMATTING ===
+Metrics/ParameterLists:
+  CountKeywordArgs: false
 
 Layout/LineLength:
   Max: 120
@@ -38,291 +39,43 @@ Layout/LineLength:
     - '^\s*context\s'  # Test contexts
     - '^\s*describe\s'  # Test descriptions
 
-Layout/MultilineMethodCallIndentation:
-  EnforcedStyle: indented
-
-Layout/FirstHashElementIndentation:
-  EnforcedStyle: consistent
-
-Layout/FirstArrayElementIndentation:
-  EnforcedStyle: consistent
-
-Layout/HashAlignment:
-  EnforcedHashRocketStyle: table
-  EnforcedColonStyle: table
-
-Layout/SpaceInsideHashLiteralBraces:
-  EnforcedStyle: space
-
-Layout/EmptyLinesAroundModuleBody:
-  Enabled: false
-
-Layout/EmptyLinesAroundClassBody:
-  Enabled: false
-
-# === STYLE ===
-
 Style/StringLiterals:
-  EnforcedStyle: single_quotes
+  EnforcedStyle: double_quotes
 
 Style/StringLiteralsInInterpolation:
-  EnforcedStyle: single_quotes
-
-Style/FrozenStringLiteralComment:
-  Enabled: true
-  EnforcedStyle: always
-  Exclude:
-    - 'examples/**/*'
-
-Style/Documentation:
-  Enabled: false
-
-Style/ClassAndModuleChildren:
-  EnforcedStyle: compact
-
-Style/TrailingCommaInArguments:
-  EnforcedStyleForMultiline: comma
-
-Style/TrailingCommaInArrayLiteral:
-  EnforcedStyleForMultiline: comma
-
-Style/TrailingCommaInHashLiteral:
-  EnforcedStyleForMultiline: comma
-
-Style/HashSyntax:
-  EnforcedStyle: ruby19_no_mixed_keys
-
-Style/Lambda:
-  EnforcedStyle: literal
-
-Style/NumericLiterals:
-  MinDigits: 6
-
-Style/BlockDelimiters:
-  EnforcedStyle: semantic
-  AllowedMethods:
-    - expect
-    - let
-    - subject
-
-Style/WordArray:
-  EnforcedStyle: brackets
-
-Style/SymbolArray:
-  EnforcedStyle: brackets
-
-Style/FormatString:
-  EnforcedStyle: percent
-
-Style/CollectionMethods:
-  PreferredMethods:
-    collect: map
-    collect!: map!
-    detect: find
-    find_all: select
-    reduce: inject
-
-Style/Alias:
-  EnforcedStyle: prefer_alias_method
-
-Style/AccessorGrouping:
-  EnforcedStyle: separated
-
-Style/BisectedAttrAccessor:
-  Enabled: true
-
-Style/RedundantAssignment:
-  Enabled: true
-
-Style/RedundantFetchBlock:
-  Enabled: true
-
-Style/RedundantFileExtensionInRequire:
-  Enabled: true
-
-Style/RedundantRegexpCharacterClass:
-  Enabled: true
-
-Style/RedundantRegexpEscape:
-  Enabled: true
-
-Style/SlicingWithRange:
-  Enabled: true
-
-Style/ExponentialNotation:
-  Enabled: true
-
-Style/HashTransformKeys:
-  Enabled: true
-
-Style/HashTransformValues:
-  Enabled: true
-
-Style/RedundantReturn:
-  AllowMultipleReturnValues: true
-
-# === METRICS ===
-
-Metrics/ModuleLength:
-  Max: 150
+  EnforcedStyle: double_quotes
 
 Metrics/ClassLength:
-  Enabled: false
-  Max: 150
+  Enabled: true
+  Max: 145
   Exclude:
     - 'test/**/*'
 
 Metrics/MethodLength:
-  Enabled: false
-  Max: 25
+  Max: 37
   Exclude:
-    - 'test/**/*'
-    - 'db/**/*'
-    - 'lib/prescient/provider/*.rb'
-
-Metrics/BlockLength:
-  Enabled: false
-  Max: 25
-  Exclude:
-    - 'test/**/*'
-    - 'lib/prescient.rb'  # Configuration block
+    - "test/**/*"
+    - "db/migrate/**/*"
 
 Metrics/AbcSize:
-  Max: 20
+  Enabled: true
+  Max: 55
   Exclude:
-    - 'test/**/*'
-    - 'db/**/*'
-    - 'lib/prescient/provider/*.rb'
+    - "test/**/*"
+    - "db/migrate/**/*"
 
-Metrics/CyclomaticComplexity:
-  Max: 8
-  Exclude:
-    - 'lib/prescient/provider/*.rb'
+Minitest/MultipleAssertions:
+  Max: 20
 
 Metrics/PerceivedComplexity:
-  Enabled: false
-  Max: 8
-  Exclude:
-    - 'lib/prescient/provider/*.rb'
-
-Metrics/ParameterLists:
-  Max: 5
-  CountKeywordArgs: false
-
-# === LINT ===
-
-Lint/RaiseException:
-  Enabled: true
-
-Lint/StructNewOverride:
-  Enabled: true
-
-Lint/DeprecatedOpenSSLConstant:
-  Enabled: true
-
-Lint/MixedRegexpCaptureTypes:
-  Enabled: true
-
-Lint/DuplicateElsifCondition:
-  Enabled: true
-
-Lint/BinaryOperatorWithIdenticalOperands:
-  Enabled: true
-
-Lint/DuplicateRescueException:
-  Enabled: true
-
-Lint/EmptyConditionalBody:
-  Enabled: true
-
-Lint/FloatComparison:
-  Enabled: true
-
-Lint/MissingSuper:
-  Enabled: true
-
-Lint/OutOfRangeRegexpRef:
-  Enabled: true
-
-Lint/SelfAssignment:
-  Enabled: true
-
-Lint/TopLevelReturnWithArgument:
-  Enabled: true
-
-Lint/UnreachableLoop:
-  Enabled: true
-
-# === NAMING ===
-
-Naming/PredicatePrefix:
-  ForbiddenPrefixes:
-    - is_
-  AllowedMethods:
-    - is_a?
-
-Naming/MemoizedInstanceVariableName:
-  EnforcedStyleForLeadingUnderscores: required
-
-Naming/VariableNumber:
-  EnforcedStyle: snake_case
-
-# === SECURITY ===
-
-Security/Open:
-  Enabled: true
-
-Security/YAMLLoad:
-  Enabled: true
-
-Security/JSONLoad:
-  Enabled: true
-
-# === PERFORMANCE ===
-
-Performance/AncestorsInclude:
-  Enabled: true
-
-Performance/BigDecimalWithNumericArgument:
-  Enabled: true
-
-Performance/RedundantSortBlock:
-  Enabled: true
-
-Performance/RedundantStringChars:
-  Enabled: true
-
-Performance/ReverseFirst:
-  Enabled: true
-
-Performance/SortReverse:
-  Enabled: true
-
-Performance/Squeeze:
-  Enabled: true
-
-Performance/StringInclude:
-  Enabled: true
-
-Performance/Sum:
-  Enabled: true
-
-# === MINITEST ===
-
-Minitest/MultipleAssertions:
   Max: 10
 
-Minitest/AssertTruthy:
-  Enabled: true
-
-Minitest/AssertWithExpectedArgument:
-  Enabled: true
+Metrics/BlockLength:
+  Max: 35
 
-Minitest/RefuteFalse:
-  Enabled: true
 
-Minitest/RefuteNil:
-  Enabled: true
+Metrics/CyclomaticComplexity:
+  Max: 10
 
-Minitest/TestMethodName:
-  Enabled: true
+Style/DirectiveScope:
+  Enabled: false

data/CHANGELOG.md

@@ -2,6 +2,65 @@
 
 ## Unreleased
 
+## [0.8.0] - 2025-08-31
+
+### Added
+
+- Added an optional, bounded Ruby agent runtime with strict single-action tool
+  execution, provider routing through `Prescient::Client`, and safe loop limits.
+- Added deterministic agent context compaction and safe serialization of tool
+  failures before they are returned to the model.
+- Added generic callable agent tools, request-scoped authorization and bounded
+  telemetry hooks, the `prescient agent` CLI command, and `POST /v1/agent`.
+- Added a dedicated `Prescient::Agent::CLIAdapter`, schema validation for
+  generic callable tools, and independent task and response byte limits.
+- Added structured failure telemetry, principal propagation, and an
+  authenticated, bounded MCP Rack transport backed by shared JSON-RPC dispatch.
+- Added valid UTF-8, JSON-safe observation truncation for bounded Agent context.
+- Extended the MCP Rack transport with authenticated sessions, lifecycle
+  termination, notifications, one-shot SSE responses, Origin checks, and a
+  reusable bearer-token authentication policy.
+- Documented the host-owned tenant/principal authorization contract and aligned
+  the Agent implementation plan with the shipped REST and MCP surfaces.
+- Added an opt-in thread-safe JSONL Agent audit sink for durable safe telemetry.
+- Added an optional lazy MCP adapter with capability discovery, safe core
+  operations, agent invocation, resources, and newline-delimited JSON-RPC stdio.
+
+### Fixed
+
+- Fixed Agent tool validation to enforce richer JSON Schema constraints,
+  composition, and local references.
+- Fixed request-scoped Agent authorization context handling for concurrent API
+  requests and added regression coverage for principal isolation.
+- Tightened generic callable Agent tools to require explicit object schemas
+  instead of accepting unconstrained arguments.
+- Added structured Agent failure telemetry for initialization failures and
+  propagated telemetry configuration through CLI and REST Agent execution.
+
+## [0.7.0] - 2025-08-17
+
+### Added
+
+- Added an explicit external-tool contract with a configurable SearXNG web-search adapter.
+- Added YAML/schema configuration for tool registration, environment references, bounded requests, and normalized search results.
+- Added `prescient search` and an annotated `web_search` configuration example.
+- Added an optional development SearXNG service to `docker-compose.yml` for runnable web-search examples.
+- Added opt-in search-to-provider context assembly through `Prescient.search_and_generate` and `prescient search --generate`.
+- Added `POST /v1/search/generate` for REST API consumers to opt in to search-result context.
+- Added `POST /v1/search` for normalized raw external-tool results without AI generation.
+- Added SearchApi as a hosted web-search adapter with engine, location, language,
+  country, API-key, timeout, and result-limit configuration.
+- Added capability groups for ordered tool-adapter fallback on transient
+  connection and rate-limit failures.
+- Added bounded JSON document sources for Ruby, CLI, and REST generation context,
+  including local files, in-memory documents, and injected Redis clients.
+- Documented SearXNG and SearchApi setup and CLI usage side by side.
+- Added explicit `--generate` opt-in behavior to the web-search example.
+- Added `SEARXNG_URL` environment defaults for automatic `web_search` registration.
+- Expanded `prescient config example` with documented SearXNG settings,
+  environment references, custom tool names, and direct-versus-generated usage.
+- Organized CLI help into global and search-specific option sections.
+
 ## [0.6.0] - 2025-08-15
 
 ### Added

data/INTEGRATION_GUIDE.md

@@ -11,7 +11,7 @@ and [examples guide](examples/README.md).
 
 ```ruby
 # Add to your Gemfile
-gem 'prescient', '~> 0.6.0'
+gem 'prescient', '~> 0.8.0'
 ```
 
 ### 2. Replace Existing AI Service
@@ -190,6 +190,9 @@ This makes the following routes available under `/prescient`:
 | `GET` | `/v1/capabilities` | Provider capabilities |
 | `GET` | `/v1/health` | Provider health |
 | `POST` | `/v1/generate` | Text generation |
+| `POST` | `/v1/search` | Normalized external-tool search |
+| `POST` | `/v1/search/generate` | Search with opt-in AI generation |
+| `POST` | `/v1/agent` | Bounded allowlisted tool-calling agent |
 | `POST` | `/v1/embeddings` | Single embedding |
 | `POST` | `/v1/embeddings/batch` | Bounded batch embeddings |
 
@@ -202,6 +205,21 @@ curl -X POST http://localhost:3000/prescient/v1/generate \
   -H "Authorization: Bearer ${PRESCIENT_API_TOKEN}" \
   -H 'Content-Type: application/json' \
   -d '{"prompt":"Explain Ruby fibers"}'
+
+curl -X POST http://localhost:3000/prescient/v1/search/generate \
+  -H "Authorization: Bearer ${PRESCIENT_API_TOKEN}" \
+  -H 'Content-Type: application/json' \
+  -d '{"query":"Ruby HTTP clients","provider":"openai","limit":5}'
+
+curl -X POST http://localhost:3000/prescient/v1/search \
+  -H "Authorization: Bearer ${PRESCIENT_API_TOKEN}" \
+  -H 'Content-Type: application/json' \
+  -d '{"query":"Ruby HTTP clients","limit":5}'
+
+curl -X POST http://localhost:3000/prescient/v1/agent \
+  -H "Authorization: Bearer ${PRESCIENT_API_TOKEN}" \
+  -H 'Content-Type: application/json' \
+  -d '{"prompt":"Summarize account status","provider":"openai","tools":[]}'
 ```
 
 Responses include a request ID. Request bodies are size-limited, batch inputs