ask-instrumentation 0.1.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +11 -2
- data/lib/ask/instrumentation/tool.rb +69 -4
- data/lib/ask/instrumentation/version.rb +1 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 19cf5f102f3034df0b07adff53aecdc83f605b6d8841e5b42151fec2efc5c3e9
|
|
4
|
+
data.tar.gz: 3bd3eec79a433ff520f4623dadaab51ffee38dcf78eae35edd1321e237be11f8
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: ea8eb3ba18f62c98fc3e112308039b6f38f0d96f9cadc7f46a8e01ea61c43751f92949c02868ada754d2a3ca60826fa43c78f4f49ecdfce0037a654a70e903b1
|
|
7
|
+
data.tar.gz: 17de99d0f28832e26c15b007dd2ff8e5da1d65a8ec832a78f76ed42eb5518eacd3debb9fdd4d0384636c9b37f7e136bfd20400ae45d3977dce43c21d5ceb52e6
|
data/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,15 @@
|
|
|
1
|
+
## [0.2.1] - 2026-06-25
|
|
2
|
+
|
|
3
|
+
### Changed
|
|
4
|
+
- Submodule tests: Chat(3t), Embedding(2t), Tool(7t). Infrastructure: rubocop, overcommit, CI matrix, gemspec, SimpleCov.
|
|
1
5
|
# Changelog
|
|
2
6
|
|
|
3
|
-
##
|
|
7
|
+
## 0.2.0 (2026-06-21)
|
|
8
|
+
|
|
9
|
+
- Fleshed out `Ask::Instrumentation::Tool` module with `instrument` helper
|
|
10
|
+
- Emits `tool_call.ask` and `tool_result.ask` events via ActiveSupport::Notifications
|
|
11
|
+
- Added structured trace logging to `log/tools/trace.jsonl`
|
|
12
|
+
|
|
13
|
+
## 0.1.0
|
|
4
14
|
|
|
5
|
-
### Added
|
|
6
15
|
- Initial release
|
|
@@ -1,10 +1,75 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require "json"
|
|
4
|
+
require "fileutils"
|
|
5
|
+
|
|
1
6
|
module Ask
|
|
2
7
|
module Instrumentation
|
|
3
|
-
# Placeholder for Tool-specific instrumentation helpers.
|
|
4
|
-
#
|
|
5
|
-
# This module will be loaded automatically when
|
|
6
|
-
# +Ask::Instrumentation::Tool+ is referenced (via +autoload+).
|
|
7
8
|
module Tool
|
|
9
|
+
TRACE_LOG_DIR = File.expand_path("log/tools", Dir.pwd)
|
|
10
|
+
|
|
11
|
+
class << self
|
|
12
|
+
def instrument(name:, arguments:, tool_call_id:, metadata: {}, &block)
|
|
13
|
+
arg_size = arguments.to_s.length
|
|
14
|
+
payload = {
|
|
15
|
+
name: name,
|
|
16
|
+
arguments: arguments,
|
|
17
|
+
argument_size: arg_size,
|
|
18
|
+
tool_call_id: tool_call_id
|
|
19
|
+
}.merge(metadata)
|
|
20
|
+
|
|
21
|
+
Ask::Instrumentation.instrument("tool_call.ask", payload)
|
|
22
|
+
|
|
23
|
+
start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
|
|
24
|
+
begin
|
|
25
|
+
result = block.call
|
|
26
|
+
duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time) * 1000).round(1)
|
|
27
|
+
result_size = result.to_s.length
|
|
28
|
+
|
|
29
|
+
result_payload = {
|
|
30
|
+
name: name,
|
|
31
|
+
duration_ms: duration_ms,
|
|
32
|
+
result_size: result_size,
|
|
33
|
+
success: true,
|
|
34
|
+
tool_call_id: tool_call_id
|
|
35
|
+
}.merge(metadata)
|
|
36
|
+
|
|
37
|
+
Ask::Instrumentation.instrument("tool_result.ask", result_payload)
|
|
38
|
+
write_trace_log(name: name, duration_ms: duration_ms, success: true,
|
|
39
|
+
argument_size: arg_size, result_size: result_size,
|
|
40
|
+
tool_call_id: tool_call_id)
|
|
41
|
+
result
|
|
42
|
+
rescue => e
|
|
43
|
+
duration_ms = ((Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time) * 1000).round(1)
|
|
44
|
+
|
|
45
|
+
error_payload = {
|
|
46
|
+
name: name,
|
|
47
|
+
duration_ms: duration_ms,
|
|
48
|
+
error: e.class.name,
|
|
49
|
+
error_message: e.message,
|
|
50
|
+
success: false,
|
|
51
|
+
tool_call_id: tool_call_id
|
|
52
|
+
}.merge(metadata)
|
|
53
|
+
|
|
54
|
+
Ask::Instrumentation.instrument("tool_result.ask", error_payload)
|
|
55
|
+
write_trace_log(name: name, duration_ms: duration_ms, success: false,
|
|
56
|
+
error: "#{e.class.name}: #{e.message}",
|
|
57
|
+
tool_call_id: tool_call_id)
|
|
58
|
+
raise
|
|
59
|
+
end
|
|
60
|
+
end
|
|
61
|
+
|
|
62
|
+
def write_trace_log(**payload)
|
|
63
|
+
entry = payload.merge(timestamp: Time.now.utc.iso8601(3))
|
|
64
|
+
dir = TRACE_LOG_DIR
|
|
65
|
+
FileUtils.mkdir_p(dir)
|
|
66
|
+
File.open(File.join(dir, "trace.jsonl"), "a") do |f|
|
|
67
|
+
f.puts(JSON.generate(entry))
|
|
68
|
+
end
|
|
69
|
+
rescue => e
|
|
70
|
+
$stderr.puts "[ask-instrumentation] Failed to write trace log: #{e.message}"
|
|
71
|
+
end
|
|
72
|
+
end
|
|
8
73
|
end
|
|
9
74
|
end
|
|
10
75
|
end
|