@agentick/core 0.4.0 → 0.5.0

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.
Files changed (75) hide show
  1. package/README.md +36 -3
  2. package/dist/.tsbuildinfo.build +1 -1
  3. package/dist/agentick-instance.d.ts.map +1 -1
  4. package/dist/agentick-instance.js +2 -1
  5. package/dist/agentick-instance.js.map +1 -1
  6. package/dist/app/session.d.ts +5 -0
  7. package/dist/app/session.d.ts.map +1 -1
  8. package/dist/app/session.js +58 -31
  9. package/dist/app/session.js.map +1 -1
  10. package/dist/app/types.d.ts +20 -4
  11. package/dist/app/types.d.ts.map +1 -1
  12. package/dist/com/object-model.d.ts.map +1 -1
  13. package/dist/com/object-model.js +8 -3
  14. package/dist/com/object-model.js.map +1 -1
  15. package/dist/compiler/collector.d.ts.map +1 -1
  16. package/dist/compiler/collector.js +14 -5
  17. package/dist/compiler/collector.js.map +1 -1
  18. package/dist/compiler/fiber-compiler.d.ts +2 -0
  19. package/dist/compiler/fiber-compiler.d.ts.map +1 -1
  20. package/dist/compiler/fiber-compiler.js +29 -1
  21. package/dist/compiler/fiber-compiler.js.map +1 -1
  22. package/dist/compiler/index.d.ts +1 -1
  23. package/dist/compiler/index.d.ts.map +1 -1
  24. package/dist/compiler/index.js.map +1 -1
  25. package/dist/compiler/structure-renderer.d.ts.map +1 -1
  26. package/dist/compiler/structure-renderer.js +4 -15
  27. package/dist/compiler/structure-renderer.js.map +1 -1
  28. package/dist/compiler/types.d.ts +2 -10
  29. package/dist/compiler/types.d.ts.map +1 -1
  30. package/dist/compiler/types.js.map +1 -1
  31. package/dist/hooks/index.d.ts +2 -2
  32. package/dist/hooks/index.d.ts.map +1 -1
  33. package/dist/hooks/index.js +2 -2
  34. package/dist/hooks/index.js.map +1 -1
  35. package/dist/hooks/knob.d.ts +12 -0
  36. package/dist/hooks/knob.d.ts.map +1 -1
  37. package/dist/hooks/knob.js +32 -2
  38. package/dist/hooks/knob.js.map +1 -1
  39. package/dist/hooks/knobs-component.d.ts +1 -0
  40. package/dist/hooks/knobs-component.d.ts.map +1 -1
  41. package/dist/hooks/knobs-component.js +5 -1
  42. package/dist/hooks/knobs-component.js.map +1 -1
  43. package/dist/hooks/lifecycle.d.ts +21 -14
  44. package/dist/hooks/lifecycle.d.ts.map +1 -1
  45. package/dist/hooks/lifecycle.js +32 -13
  46. package/dist/hooks/lifecycle.js.map +1 -1
  47. package/dist/hooks/runtime-context.d.ts +12 -1
  48. package/dist/hooks/runtime-context.d.ts.map +1 -1
  49. package/dist/hooks/runtime-context.js +21 -0
  50. package/dist/hooks/runtime-context.js.map +1 -1
  51. package/dist/hooks/types.d.ts +8 -0
  52. package/dist/hooks/types.d.ts.map +1 -1
  53. package/dist/hooks/types.js.map +1 -1
  54. package/dist/index.d.ts +2 -2
  55. package/dist/index.d.ts.map +1 -1
  56. package/dist/index.js +1 -1
  57. package/dist/index.js.map +1 -1
  58. package/dist/jsx/jsx-runtime.d.ts +6 -0
  59. package/dist/jsx/jsx-runtime.d.ts.map +1 -1
  60. package/dist/jsx/jsx-runtime.js.map +1 -1
  61. package/dist/testing/compile-agent.d.ts +4 -3
  62. package/dist/testing/compile-agent.d.ts.map +1 -1
  63. package/dist/testing/compile-agent.js +2 -2
  64. package/dist/testing/compile-agent.js.map +1 -1
  65. package/dist/testing/test-runner.d.ts +7 -7
  66. package/dist/testing/test-runner.js +8 -8
  67. package/dist/tool/tool.d.ts +13 -1
  68. package/dist/tool/tool.d.ts.map +1 -1
  69. package/dist/tool/tool.js +39 -6
  70. package/dist/tool/tool.js.map +1 -1
  71. package/dist/utils/token-estimate.d.ts +4 -3
  72. package/dist/utils/token-estimate.d.ts.map +1 -1
  73. package/dist/utils/token-estimate.js +16 -15
  74. package/dist/utils/token-estimate.js.map +1 -1
  75. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"compile-agent.js","sourceRoot":"","sources":["../../src/testing/compile-agent.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"compile-agent.js","sourceRoot":"","sources":["../../src/testing/compile-agent.ts"],"names":[],"mappings":"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"}
@@ -15,7 +15,7 @@
15
15
  * // ... run agent ...
16
16
  *
17
17
  * expect(tracker.initCalls).toHaveLength(1);
18
- * expect(tracker.prepareModelInputCalls).toHaveLength(1);
18
+ * expect(tracker.transformCompiledCalls).toHaveLength(1);
19
19
  * expect(tracker.toolCalls).toHaveLength(1);
20
20
  * ```
21
21
  */
@@ -50,7 +50,7 @@ export interface TestRunnerOptions {
50
50
  */
51
51
  interceptTools?: Record<string, string | ((call: ToolCall) => ToolResult | Promise<ToolResult>)>;
52
52
  /**
53
- * Transform function for prepareModelInput.
53
+ * Transform function for transformCompiled.
54
54
  * If not provided, input passes through unchanged.
55
55
  */
56
56
  transformInput?: (compiled: COMInput, tools: ExecutableTool[]) => COMInput | Promise<COMInput>;
@@ -62,8 +62,8 @@ export interface TestRunnerOptions {
62
62
  export interface RunnerTracker {
63
63
  /** All onSessionInit calls (session IDs) */
64
64
  initCalls: string[];
65
- /** All prepareModelInput calls */
66
- prepareModelInputCalls: Array<{
65
+ /** All transformCompiled calls */
66
+ transformCompiledCalls: Array<{
67
67
  tools: string[];
68
68
  }>;
69
69
  /** All executeToolCall calls */
@@ -97,7 +97,7 @@ export interface TestRunnerResult {
97
97
  * await session.send({ messages: [...] }).result;
98
98
  *
99
99
  * expect(tracker.initCalls).toHaveLength(1);
100
- * expect(tracker.prepareModelInputCalls).toHaveLength(1);
100
+ * expect(tracker.transformCompiledCalls).toHaveLength(1);
101
101
  * ```
102
102
  *
103
103
  * @example Intercepting tools
@@ -108,12 +108,12 @@ export interface TestRunnerResult {
108
108
  * // When model calls "execute" tool, it gets "sandboxed!" instead of real execution
109
109
  * ```
110
110
  *
111
- * @example Transforming model input
111
+ * @example Transforming compiled input
112
112
  * ```typescript
113
113
  * const { runner } = createTestRunner({
114
114
  * transformInput: (compiled, tools) => ({
115
115
  * ...compiled,
116
- * tools: [], // Remove all tools from model input
116
+ * tools: [], // Remove all tools from compiled input
117
117
  * }),
118
118
  * });
119
119
  * ```
@@ -15,7 +15,7 @@
15
15
  * // ... run agent ...
16
16
  *
17
17
  * expect(tracker.initCalls).toHaveLength(1);
18
- * expect(tracker.prepareModelInputCalls).toHaveLength(1);
18
+ * expect(tracker.transformCompiledCalls).toHaveLength(1);
19
19
  * expect(tracker.toolCalls).toHaveLength(1);
20
20
  * ```
21
21
  */
@@ -33,7 +33,7 @@
33
33
  * await session.send({ messages: [...] }).result;
34
34
  *
35
35
  * expect(tracker.initCalls).toHaveLength(1);
36
- * expect(tracker.prepareModelInputCalls).toHaveLength(1);
36
+ * expect(tracker.transformCompiledCalls).toHaveLength(1);
37
37
  * ```
38
38
  *
39
39
  * @example Intercepting tools
@@ -44,12 +44,12 @@
44
44
  * // When model calls "execute" tool, it gets "sandboxed!" instead of real execution
45
45
  * ```
46
46
  *
47
- * @example Transforming model input
47
+ * @example Transforming compiled input
48
48
  * ```typescript
49
49
  * const { runner } = createTestRunner({
50
50
  * transformInput: (compiled, tools) => ({
51
51
  * ...compiled,
52
- * tools: [], // Remove all tools from model input
52
+ * tools: [], // Remove all tools from compiled input
53
53
  * }),
54
54
  * });
55
55
  * ```
@@ -58,14 +58,14 @@ export function createTestRunner(options = {}) {
58
58
  const { name = "test", interceptTools = {}, transformInput, persistData } = options;
59
59
  const tracker = {
60
60
  initCalls: [],
61
- prepareModelInputCalls: [],
61
+ transformCompiledCalls: [],
62
62
  toolCalls: [],
63
63
  persistCalls: [],
64
64
  restoreCalls: [],
65
65
  destroyCalls: [],
66
66
  reset() {
67
67
  this.initCalls = [];
68
- this.prepareModelInputCalls = [];
68
+ this.transformCompiledCalls = [];
69
69
  this.toolCalls = [];
70
70
  this.persistCalls = [];
71
71
  this.restoreCalls = [];
@@ -77,8 +77,8 @@ export function createTestRunner(options = {}) {
77
77
  onSessionInit(session) {
78
78
  tracker.initCalls.push(session.id);
79
79
  },
80
- async prepareModelInput(compiled, tools) {
81
- tracker.prepareModelInputCalls.push({
80
+ async transformCompiled(compiled, tools) {
81
+ tracker.transformCompiledCalls.push({
82
82
  tools: tools.map((t) => t.metadata?.name ?? "unknown"),
83
83
  });
84
84
  if (transformInput) {
@@ -230,13 +230,25 @@ export interface CreateToolOptions<TInput = any, TOutput extends ContentBlock[]
230
230
  * - await MyTool.run(input) -- calls static run procedure
231
231
  * - <MyTool /> -- renders component that registers tool
232
232
  */
233
+ /**
234
+ * Fields that can be overridden via JSX props on tool components.
235
+ * Notably excludes `input` (schema) — overriding schema without the handler is a type-safety foot-gun.
236
+ * To change the schema, create a new tool.
237
+ */
238
+ declare const OVERRIDABLE_FIELDS: readonly ["name", "description", "requiresConfirmation", "confirmationMessage", "intent", "type", "providerOptions", "libraryOptions"];
239
+ type OverridableField = (typeof OVERRIDABLE_FIELDS)[number];
240
+ /**
241
+ * Props that can be overridden on tool components via JSX.
242
+ * Derived from OVERRIDABLE_FIELDS — single source of truth.
243
+ */
244
+ export type ToolPropOverrides = Partial<Pick<ToolMetadata, OverridableField>>;
233
245
  export interface ToolClass<TInput = any> {
234
246
  /** Tool metadata (static property) */
235
247
  metadata: ToolMetadata<TInput>;
236
248
  /** Run procedure (static property). Undefined for client-only tools. */
237
249
  run?: Procedure<ToolHandler<TInput>>;
238
250
  /** Functional component that registers the tool on mount */
239
- (props?: ComponentBaseProps): React.ReactElement | null;
251
+ (props?: ComponentBaseProps & ToolPropOverrides): React.ReactElement | null;
240
252
  }
241
253
  /**
242
254
  * ToolClass with run guaranteed to be defined (when handler is provided).
@@ -1 +1 @@
1
- {"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tool/tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/tool/tool.ts"],"names":[],"mappings":"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"}
package/dist/tool/tool.js CHANGED
@@ -16,6 +16,31 @@ import {} from "../component/component";
16
16
  import { useCom, useTickState, useOnTickStart, useOnTickEnd, useAfterCompile } from "../hooks";
17
17
  // Re-export for convenience
18
18
  export { ToolIntent, ToolExecutionType, } from "@agentick/shared/tools";
19
+ /**
20
+ * A ToolClass is both:
21
+ * - An ExecutableTool (via static metadata/run) - can be passed to models
22
+ * - A functional component - can be used in JSX
23
+ *
24
+ * This enables the three usage patterns:
25
+ * - engine.execute({ tools: [MyTool] }) -- passes static metadata/run
26
+ * - await MyTool.run(input) -- calls static run procedure
27
+ * - <MyTool /> -- renders component that registers tool
28
+ */
29
+ /**
30
+ * Fields that can be overridden via JSX props on tool components.
31
+ * Notably excludes `input` (schema) — overriding schema without the handler is a type-safety foot-gun.
32
+ * To change the schema, create a new tool.
33
+ */
34
+ const OVERRIDABLE_FIELDS = [
35
+ "name",
36
+ "description",
37
+ "requiresConfirmation",
38
+ "confirmationMessage",
39
+ "intent",
40
+ "type",
41
+ "providerOptions",
42
+ "libraryOptions",
43
+ ];
19
44
  // Implementation
20
45
  export function createTool(options) {
21
46
  // Build metadata from options
@@ -58,7 +83,16 @@ export function createTool(options) {
58
83
  // Create functional component with static tool properties
59
84
  // Using a functional component instead of a class ensures compatibility
60
85
  // with React's reconciler (class components must extend React.Component)
61
- const ToolComponent = function ToolComponent(_props) {
86
+ const ToolComponent = function ToolComponent(props) {
87
+ // Merge JSX prop overrides with default metadata
88
+ // Props take priority over createTool defaults
89
+ const overrides = {};
90
+ for (const field of OVERRIDABLE_FIELDS) {
91
+ if (props[field] !== undefined) {
92
+ overrides[field] = props[field];
93
+ }
94
+ }
95
+ const effectiveMetadata = { ...metadata, ...overrides };
62
96
  const ctx = useCom();
63
97
  // Note: useTickState returns hooks/types.ts TickState, but lifecycle callbacks
64
98
  // expect component/component.ts TickState. They're compatible at runtime,
@@ -142,12 +176,11 @@ export function createTool(options) {
142
176
  // Render a <tool> element for the collector to find
143
177
  // This is the declarative approach - tools are collected from the tree
144
178
  const toolElement = React.createElement("tool", {
145
- name: metadata.name,
146
- description: metadata.description,
147
- schema: metadata.input,
179
+ name: effectiveMetadata.name,
180
+ description: effectiveMetadata.description,
181
+ schema: effectiveMetadata.input,
148
182
  handler: effectiveRun,
149
- // Include full metadata for advanced use cases
150
- metadata,
183
+ metadata: effectiveMetadata,
151
184
  });
152
185
  // If custom render provided, wrap both tool element and render output
153
186
  if (options.render) {
@@ -1 +1 @@
1
- {"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tool/tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tool.js","sourceRoot":"","sources":["../../src/tool/tool.ts"],"names":[],"mappings":"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"}
@@ -8,7 +8,8 @@
8
8
  * visualization, not for accurate billing or context window management.
9
9
  */
10
10
  import type { Message, ContentBlock, ToolDefinition } from "@agentick/shared";
11
- import type { CompiledStructure, CompiledTimelineEntry, CompiledTool, CompiledSection } from "../compiler/types";
11
+ import type { CompiledStructure, CompiledTimelineEntry, CompiledSection } from "../compiler/types";
12
+ import type { ExecutableTool } from "../tool/tool";
12
13
  import type { SemanticContentBlock } from "../renderers/types";
13
14
  /**
14
15
  * Estimate token count from text.
@@ -42,9 +43,9 @@ export declare function estimateTimelineEntryTokens(entry: CompiledTimelineEntry
42
43
  */
43
44
  export declare function estimateSectionTokens(section: CompiledSection): number;
44
45
  /**
45
- * Estimate tokens for a compiled tool.
46
+ * Estimate tokens for a tool (ExecutableTool or ToolDefinition).
46
47
  */
47
- export declare function estimateToolTokens(tool: CompiledTool | ToolDefinition): number;
48
+ export declare function estimateToolTokens(tool: ExecutableTool | ToolDefinition): number;
48
49
  /**
49
50
  * Token summary for a compiled structure.
50
51
  */
@@ -1 +1 @@
1
- {"version":3,"file":"token-estimate.d.ts","sourceRoot":"","sources":["../../src/utils/token-estimate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,EACZ,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAQ/D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,oBAAoB,GAAG,MAAM,CAgCtF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAM9D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAMhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAStE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,GAAG,MAAM,CAgB9E;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,YAAY,CA4D7E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvD"}
1
+ {"version":3,"file":"token-estimate.d.ts","sourceRoot":"","sources":["../../src/utils/token-estimate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAQ/D;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,oBAAoB,GAAG,MAAM,CAgCtF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAM9D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAMhF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAStE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,MAAM,CAehF;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,YAAY,CA4D7E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvD"}
@@ -98,23 +98,24 @@ export function estimateSectionTokens(section) {
98
98
  return total;
99
99
  }
100
100
  /**
101
- * Estimate tokens for a compiled tool.
101
+ * Estimate tokens for a tool (ExecutableTool or ToolDefinition).
102
102
  */
103
103
  export function estimateToolTokens(tool) {
104
104
  let total = 0;
105
- total += estimateTokens(tool.name);
106
- if (tool.description) {
107
- total += estimateTokens(tool.description);
108
- }
109
- if (tool.schema) {
110
- total += estimateTokens(JSON.stringify(tool.schema));
111
- }
112
- if (tool.input) {
113
- total += estimateTokens(JSON.stringify(tool.input));
114
- }
115
- if (tool.output) {
116
- total += estimateTokens(JSON.stringify(tool.output));
117
- }
105
+ // ExecutableTool: metadata.name/description/input
106
+ // ToolDefinition: name/description/input directly
107
+ const name = tool.metadata?.name ?? tool.name;
108
+ const description = tool.metadata?.description ?? tool.description;
109
+ const input = tool.metadata?.input ?? tool.input;
110
+ const output = tool.output;
111
+ if (name)
112
+ total += estimateTokens(name);
113
+ if (description)
114
+ total += estimateTokens(description);
115
+ if (input)
116
+ total += estimateTokens(JSON.stringify(input));
117
+ if (output)
118
+ total += estimateTokens(JSON.stringify(output));
118
119
  return total;
119
120
  }
120
121
  /**
@@ -156,7 +157,7 @@ export function computeTokenSummary(compiled) {
156
157
  for (const tool of compiled.tools) {
157
158
  const toolTokens = estimateToolTokens(tool);
158
159
  tools += toolTokens;
159
- byComponent.set(`tool:${tool.name}`, toolTokens);
160
+ byComponent.set(`tool:${tool.metadata.name}`, toolTokens);
160
161
  }
161
162
  // Ephemeral content
162
163
  for (const eph of compiled.ephemeral) {
@@ -1 +1 @@
1
- {"version":3,"file":"token-estimate.js","sourceRoot":"","sources":["../../src/utils/token-estimate.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"token-estimate.js","sourceRoot":"","sources":["../../src/utils/token-estimate.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agentick/core",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "Core engine for Agentick",
5
5
  "keywords": [
6
6
  "agent",