@atgs/tapeworm 0.0.2 → 0.1.1

package/dist/tapeworm.umd.js

@@ -1 +1 @@
-(function(o,h){typeof exports=="object"&&typeof module<"u"?h(exports):typeof define=="function"&&define.amd?define(["exports"],h):(o=typeof globalThis<"u"?globalThis:o||self,h(o.Tapeworm={}))})(this,(function(o){"use strict";class h{messages;manager;constructor(){this.messages=[],this.manager=new y}append(e){this.messages.push(e),this.messages=this.manager.compact(this.messages)}}class l{role;content;toolCalls;toolName;thinking;constructor(e,s,t,n,r){this.role=e,this.content=s,this.toolCalls=t,this.toolName=n,this.thinking=r}setRole(e){this.role=e}setContent(e){this.content=e}setToolCalls(e){this.toolCalls=e}static builder(){return new _}}class _{_role;_content;_toolCalls;_toolName;_thinking;role(e){return this._role=e,this}content(e){return this._content=e,this}toolCalls(e){return this._toolCalls=e,this}toolName(e){return this._toolName=e,this}thinking(e){return this._thinking=e,this}build(){return new l(this._role,this._content,this._toolCalls,this._toolName,this._thinking)}}class f{compact(e){throw new T("No implementation for conversation manager!")}configure(e){throw new T("No implementation for conversation manager!")}}class y extends f{compact(e){return e}configure(e){}}class T extends Error{constructor(e){super(e),this.name="ConversationManagerNotImplemented"}}class v{async invoke(e){throw new M("The invoke function for this model was not correctly implemented.")}tokenLimit(){throw new M("The tokenLimit function for this model was not correctly implemented.")}}class w{messages;tools;constructor(e,s){this.messages=e,this.tools=s}static builder(){return new c}}class c{_messages;_tools;messages(e){return this._messages=e,this}tools(e){return this._tools=e,this}build(){return this._tools==null&&(this._tools=[]),new w(this._messages,this._tools)}}class b{toolCalls;role;content;thinking;constructor(e,s,t,n){this.toolCalls=e,this.role=s,this.content=t,this.thinking=n}static builder(){return new m}}class m{_toolCalls;_role;_content;_thinking;toolCalls(e){return this._toolCalls=e,this}role(e){return this._role=e,this}content(e){return this._content=e,this}thinking(e){return this._thinking=e,this}build(){return new b(this._toolCalls,this._role,this._content,this._thinking)}}class M extends Error{constructor(e){super(e),this.name="ModelNotImplementedError"}}class S{name;system_prompt;tools;model;conversation;conversationManager;toolNameToIndexMap;async invoke(e){this.conversation==null&&(this.conversation=new h,this.conversationManager!=null&&(this.conversation.manager=this.conversationManager),this.conversation.append(l.builder().role("system").content(this.system_prompt).build())),this.conversation.append(l.builder().role("user").content(e).build());let s=!1;for(;!s;){let t=await this._runQuery();if(this.conversation.append(l.builder().role(t.role??"assistant").content(t.content??"").thinking(t.thinking??"").build()),console.log("Assistant thinking: "+t.thinking),console.log("Assistant reply: "+t.content),s=!0,t.toolCalls!=null&&t.toolCalls.length!=0){s=!1,t.toolCalls.sort((n,r)=>(n.sequence??0)<(r.sequence??0)?-1:1);for(let n in t.toolCalls)this._runTool(t.toolCalls[n])}}}async _runQuery(){return await this.model.invoke(new c().messages(this.conversation?.messages).tools(this.tools).build())}async _runTool(e){if(console.log("Calling tool: "+JSON.stringify(e)),this.generateToolNameToIndexMap(),!(e.name in this.toolNameToIndexMap)){this.conversation.append(l.builder().role("tool").toolName(e.name).content(JSON.stringify({error:"tool does not exist"})).build());return}let s=this.tools[this.toolNameToIndexMap[e.name]];try{let t=s.execute(e.parameters);this.conversation.append(l.builder().role("tool").toolName(e.name).content(JSON.stringify(t)).build())}catch(t){this.conversation.append(l.builder().role("tool").toolName(e.name).content(JSON.stringify(t)).build())}}generateToolNameToIndexMap(){if(this.toolNameToIndexMap==null){this.toolNameToIndexMap={};for(let e=0;e<this.tools.length;e++)this.toolNameToIndexMap[this.tools[e].getName()]=e}}}class d extends Error{constructor(e){super(e),this.name="ToolNotDefinedError"}}class B{name;description;tool_schema;constructor(){this.name=this.getName(),this.description=this.getDescription(),this.tool_schema=this.getToolSchema()}getName(){throw new d("Tool name not defined.")}getDescription(){throw new d("Tool description not defined.")}getToolSchema(){throw new d("Tool parameter schema not defined.")}execute(e){return null}}class p{sequence;name;parameters;type;constructor(e,s,t,n){this.sequence=e,this.name=s,this.parameters=t,this.type=n}static builder(){return new N}}class N{_sequence;_name;_parameters;_type;sequence(e){return this._sequence=e,this}name(e){return this._name=e,this}parameters(e){return this._parameters=e,this}type(e){return this._type=e,this}build(){return this._sequence==null&&(this._sequence=0),new p(this._sequence,this._name,this._parameters,this._type)}}class C{parameters;output;constructor(e,s){this.parameters=e,this.output=s}static builder(){return new q}}class q{_parameters;_output;addParameter(e){return this._parameters==null&&(this._parameters=[]),this._parameters.push(e),this}output(e){return this._output=e,this}build(){return this._parameters==null&&(this._parameters=[]),new C(this._parameters,this._output)}}class k{name;description;type;required;constructor(e,s,t,n){this.name=e,this.description=s,this.type=t,this.required=n,this.assertValidType()}assertValidType(){}static builder(){return new O}}class O{_name;_description;_type;_required;name(e){return this._name=e,this}description(e){return this._description=e,this}type(e){return this._type=e,this}required(e){return this._required=e,this}build(){return this._required==null&&(this._required=!1),new k(this._name,this._description,this._type,this._required)}}class I extends v{endpoint;model;options;constructor(e,s,t){super(),this.endpoint=e,this.model=s,this.options=t}async invoke(e){let s={model:this.model,messages:this._formatMessages(e),tools:this._formatTools(e),...this.options},t=await fetch(this.endpoint+"/api/chat",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(s)});if(!t.ok)throw new Error(`HTTP error! status: ${t.status}`);let n=await t.json(),r=[];if(n.message.tool_calls)for(let g in n.message.tool_calls){const a=n.message.tool_calls[g];let u="function",j=a[u]?.name,E=a[u]?.index,R=a[u]?.arguments;r.push(p.builder().name(j).type(u).parameters(R).sequence(E).build())}return new m().toolCalls(r).role(n.message.role).content(n.message.content).thinking(n.message.thinking).build()}_formatTools(e){let s=[],t=[];for(let n of e.tools){let r={};for(let a of n.getToolSchema().parameters)r[a.name]={},r[a.name].type=a.name,r[a.name].description=a.description,a.required&&t.push(a.name);let g={type:"function",function:{name:n.getName(),description:n.getDescription(),parameters:{type:"object",properties:r,required:t}}};s.push(g)}return s}_formatMessages(e){let s=[];for(let t of e.messages){if(t.role=="assistant"||t.role=="system"||t.role=="user"){s.push(t);continue}t.role=="tool"&&s.push({role:"tool",content:t.content,tool_name:t.toolName})}return s}}o.Agent=S,o.Conversation=h,o.ConversationManager=f,o.DefaultConversationManager=y,o.Message=l,o.MessageBuilder=_,o.Model=v,o.ModelRequest=w,o.ModelRequestBuilder=c,o.ModelResponse=b,o.ModelResponseBuilder=m,o.OllamaModel=I,o.Parameter=k,o.ParameterBuilder=O,o.Tool=B,o.ToolCall=p,o.ToolCallBuilder=N,o.ToolSchema=C,o.ToolSchemaBuilder=q,Object.defineProperty(o,Symbol.toStringTag,{value:"Module"})}));
+(function(i,u){typeof exports=="object"&&typeof module<"u"?u(exports):typeof define=="function"&&define.amd?define(["exports"],u):(i=typeof globalThis<"u"?globalThis:i||self,u(i.Tapeworm={}))})(this,(function(i){"use strict";class u{messages;manager;constructor(){this.messages=[],this.manager=new g}append(e){this.messages.push(e),this.messages=this.manager.compact(this.messages)}}class v{compact(e){throw new y("No implementation for conversation manager!")}configure(e){throw new y("No implementation for conversation manager!")}}class g extends v{compact(e){return e}configure(e){}}class y extends Error{constructor(e){super(e),this.name="ConversationManagerNotImplemented"}}class c{role;content;constructor(e,t){this.role=e,this.content=t}static builder(){return new M}filter(e){return this.content.filter(t=>t.getMessageComponentType()==e)}}class M{_role;_content;role(e){return this._role=e,this}init(){this._content==null&&(this._content=[])}toolCall(e){return e==null?this:(this.init(),this._content.push(e),this)}toolCalls(e){if(e==null)return this;this.init();for(const t of e)this._content.push(t);return this}toolResult(e){return e==null?this:(this.init(),this._content.push(e),this)}thinking(e){return e==null?this:(this.init(),this._content.push(b.of(e)),this)}content(e){return e==null?this:(this.init(),this._content.push(w.of(e)),this)}build(){if(this._content==null||this._content.length==0)throw new Error("Role-only messages are not supported by Tapeworm.");return new c(this._role,this._content)}}const l={Content:"content",Thinking:"thinking",ToolCall:"toolcall",ToolResult:"toolresult"};class d{getMessageComponentType(){throw new Error("Message components that do not have a message component type are not allowed.")}}class w extends d{text;constructor(e){super(),this.text=e}getMessageComponentType(){return l.Content}get(){return this.text}static of(e){return new this(e)}}class b extends d{thought;constructor(e){super(),this.thought=e}getMessageComponentType(){return l.Thinking}get(){return this.thought}static of(e){return new this(e)}}class p extends d{id;toolName;toolResult;constructor(e,t,o){super(),this.id=e,this.toolName=t,this.toolResult=o}getMessageComponentType(){return l.ToolResult}static of(e,t){return new this(e.id,e.name,t)}}class C{async invoke(e){throw new k("The invoke function for this model was not correctly implemented.")}tokenLimit(){throw new k("The tokenLimit function for this model was not correctly implemented.")}}class N{messages;tools;constructor(e,t){this.messages=e,this.tools=t}static builder(){return new f}}class f{_messages;_tools;messages(e){return this._messages=e,this}tools(e){return this._tools=e,this}build(){if(this._tools==null&&(this._tools=[]),this._messages==null)throw new O("Requests to the model should include content.");return new N(this._messages,this._tools)}}class k extends Error{constructor(e){super(e),this.name="ModelNotImplementedError"}}class O extends Error{constructor(e){super(e),this.name="MessagesNotDefinedError"}}class _ extends d{sequence;name;parameters;type;id;getMessageComponentType(){return l.ToolCall}constructor(e,t,o,s,r){super(),this.sequence=e,this.name=t,this.parameters=o,this.type=s,this.id=r}static builder(){return new q}}class q{_sequence;_name;_parameters;_type;_id;sequence(e){return this._sequence=e,this}name(e){return this._name=e,this}parameters(e){return this._parameters=e,this}type(e){return this._type=e,this}id(e){return e!=null&&(this._id=e),this}build(){return this._sequence==null&&(this._sequence=0),this._id==null&&(this._id=(Math.random()+1).toString(36).slice(2,7)),new _(this._sequence,this._name,this._parameters,this._type,this._id)}}class I extends Error{constructor(e){super(e),this.name="ToolNotFoundError"}}class R{name;systemPrompt;tools;model;conversation;conversationManager;toolNameToIndexMap;callback;constructor(e,t,o,s,r){this.name=e,this.model=o,this.conversationManager=s,this.tools=t,this.callback=r,this.conversationManager.configure(o)}async invoke(e){this.conversation==null&&(this.conversation=new u,this.conversationManager!=null&&(this.conversation.manager=this.conversationManager),this.systemPrompt!=null&&this.conversation.append(c.builder().role("system").content(this.systemPrompt).build())),this.conversation.append(c.builder().role("user").content(e).build());let t=!1;for(;!t;){let o=await this._runQuery();this.callback(o),this.conversation.append(o),t=!0;const s=o.filter(l.ToolCall);if(s!=null&&s.length!=0){t=!1,s.sort((r,h)=>(r.sequence??0)<(h.sequence??0)?-1:1);for(let r of s)await this._runTool(r)}}}async _runQuery(){return await this.model.invoke(new f().messages(this.conversation?.messages).tools(this.tools).build())}async _runTool(e){if(this.generateToolNameToIndexMap(),!(e.name in this.toolNameToIndexMap)){this.conversation.append(c.builder().role("tool").toolResult(p.of(e,new I("Agent does not have a tool with this name."))).build());return}let t=this.tools[this.toolNameToIndexMap[e.name]];try{let o=await t.execute(e.parameters);this.conversation.append(c.builder().role("tool").toolResult(p.of(e,o)).build())}catch(o){this.conversation.append(c.builder().role("tool").toolResult(p.of(e,JSON.stringify(o))).build())}}generateToolNameToIndexMap(){if(this.toolNameToIndexMap==null){this.toolNameToIndexMap={};for(let e=0;e<this.tools.length;e++)this.toolNameToIndexMap[this.tools[e].getName()]=e}}static builder(){return new j}}class j{_name;_systemPrompt;_tools;_model;_conversation;_conversationManager=new g;_toolNameToIndexMap;_callback=e=>x(e);name(e){return this._name=e,this}systemPrompt(e){return this._systemPrompt=e,this}tools(e){return this._tools=e,this}addTool(e){return this._tools==null&&(this._tools=[]),this._tools.push(e),this}model(e){return this._model=e,this}conversationManager(e){return this._conversationManager=e,this}callback(e){return this._callback=e,this}build(){let e=new R(this._name,this._tools,this._model,this._conversationManager,this._callback);return this._conversation!=null&&(e.conversation=this._conversation),this._systemPrompt!=null&&(e.systemPrompt=this._systemPrompt),e}}function x(n){for(const e of n.filter(l.Thinking))console.log("\x1B[90m"+e.get()+"\x1B[0m");for(const e of n.filter(l.Content))console.log(e.get());for(const e of n.filter(l.ToolCall))console.log("\x1B[32mCalling Tool: "+e.name+"\x1B[0m")}class T extends Error{constructor(e){super(e),this.name="ToolNotDefinedError"}}class D{name;description;tool_schema;constructor(){this.name=this.getName(),this.description=this.getDescription(),this.tool_schema=this.getToolSchema()}getName(){throw new T("Tool name not defined.")}getDescription(){throw new T("Tool description not defined.")}getToolSchema(){throw new T("Tool parameter schema not defined.")}execute(e){return null}}class E{parameters;output;constructor(e,t){this.parameters=e,this.output=t}static builder(){return new P}}class P{_parameters;_output;addParameter(e){return this._parameters==null&&(this._parameters=[]),this._parameters.push(e),this}output(e){return this._output=e,this}build(){return this._parameters==null&&(this._parameters=[]),new E(this._parameters,this._output)}}class S{name;description;type;required;constructor(e,t,o,s){this.name=e,this.description=t,this.type=o,this.required=s,this.assertValidType()}assertValidType(){}static builder(){return new B}}class B{_name;_description;_type;_required;name(e){return this._name=e,this}description(e){return this._description=e,this}type(e){return this._type=e,this}required(e){return this._required=e,this}build(){return this._required==null&&(this._required=!1),new S(this._name,this._description,this._type,this._required)}}class A extends C{endpoint;model;options;constructor(e,t,o){super(),this.endpoint=e,this.model=t,this.options=o}async invoke(e){let t={model:this.model,messages:this._formatMessages(e),tools:this._formatTools(e),...this.options},o=await fetch(this.endpoint+"/api/chat",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify(t)});if(!o.ok)throw new Error(`HTTP error! status: ${o.status}`);let s=await o.json(),r=[];if(s.message.tool_calls)for(let h in s.message.tool_calls){const a=s.message.tool_calls[h];let m="function",J=a[m]?.name,F=a[m]?.index,L=a.id??void 0,Q=typeof a[m]?.arguments=="string"?JSON.parse(a[m]?.arguments):a[m]?.arguments;r.push(_.builder().name(J).type(m).parameters(Q).sequence(F).id(L).build())}return c.builder().toolCalls(r).role(s.message.role).content(s.message.content).thinking(s.message.thinking).build()}_formatTools(e){let t=[];for(let o of e.tools){let s={},r=[];for(let a of o.getToolSchema().parameters)s[a.name]={},s[a.name].type=a.type,s[a.name].description=a.description,a.required&&r.push(a.name);let h={type:"function",function:{name:o.getName(),description:o.getDescription(),parameters:{type:"object",properties:s,required:r}}};t.push(h)}return t}_formatMessages(e){let t=[];for(let o of e.messages){if(o.role=="assistant"||o.role=="system"||o.role=="user"){t.push(this._formatSingleMessage(o));continue}if(o.role=="tool"){for(const s of o.content)if(s.getMessageComponentType()==l.ToolResult){const r=s;t.push({role:o.role,name:r.toolName,content:JSON.stringify(r.toolResult)})}}}return t}_formatSingleMessage(e){let t={role:e.role},o,s,r;for(const h of e.content){if(h.getMessageComponentType()==l.Content){const a=h;o==null&&(o=""),o+=a.get()}if(h.getMessageComponentType()==l.Thinking){const a=h;r==null&&(r=""),r+=a.get()}if(h.getMessageComponentType()==l.ToolCall){const a=h;s==null&&(s=[]),s.push(this._formatToolCall(a))}}return o!=null&&(t.content=o),s!=null&&(t.tool_calls=s),r!=null&&(t.thinking=r),t}_formatToolCall(e){return{function:{name:e.name,arguments:e.parameters}}}}i.Agent=R,i.Content=w,i.Conversation=u,i.ConversationManager=v,i.DefaultConversationManager=g,i.Message=c,i.MessageBuilder=M,i.MessageComponent=d,i.MessageComponentType=l,i.Model=C,i.ModelRequest=N,i.ModelRequestBuilder=f,i.OllamaModel=A,i.Parameter=S,i.ParameterBuilder=B,i.Thinking=b,i.Tool=D,i.ToolCall=_,i.ToolCallBuilder=q,i.ToolResult=p,i.ToolSchema=E,i.ToolSchemaBuilder=P,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));

package/dist/tool/tool.d.ts

@@ -7,9 +7,29 @@ export default class Tool {
     private name;
     private description;
     private tool_schema;
+    /**
+     * Initialize tool metadata from subclass implementations.
+     */
     constructor();
+    /**
+     * Name that uniquely identifies this tool.
+     * @returns A short, stable identifier string.
+     */
     getName(): string;
+    /**
+     * Human-readable description of what the tool does.
+     * @returns Description string shown to the model.
+     */
     getDescription(): string;
+    /**
+     * Structured schema describing tool parameters and output.
+     * @returns ToolSchema instance.
+     */
     getToolSchema(): ToolSchema;
-    execute(input: any): any;
+    /**
+     * Execute the tool against provided input parameters.
+     * @param input Parsed arguments from the model.
+     * @returns Tool-specific output.
+     */
+    execute(_input: any): any;
 }

package/dist/tool/toolCall.d.ts

@@ -1,13 +1,34 @@
+import { MessageComponent, MessageComponentType } from "../conversation/message";
 /**
  * Represents a single tool invocation returned by a model, including the target
  * tool name, argument map, type (function/spec), and optional sequence number.
+ *
+ * The ToolCall object is also a MessageComponent and thus is a component of Message.
  */
-export default class ToolCall {
+export default class ToolCall extends MessageComponent {
     sequence: number | undefined;
     name: string;
     parameters: any;
     type: string;
-    constructor(sequence: number | undefined, name: string, parameters: any, type: string);
+    id: string;
+    /**
+     * Get the type of this message component, as defined in MessageComponentType.
+     * This returns MessageComponentType.ToolCall.
+     */
+    getMessageComponentType(): MessageComponentType;
+    /**
+     * Create a ToolCall component to represent a model-requested tool invocation.
+     * @param sequence Optional ordering from the model for batched tool calls.
+     * @param name Name of the tool to invoke.
+     * @param parameters Arguments provided by the model.
+     * @param type Type of tool call (e.g., function).
+     * @param id Provider-generated identifier for correlating results.
+     */
+    constructor(sequence: number | undefined, name: string, parameters: any, type: string, id: string);
+    /**
+     * Convenience factory for a ToolCallBuilder.
+     * @returns A new ToolCallBuilder instance.
+     */
     static builder(): ToolCallBuilder;
 }
 /**
@@ -18,9 +39,46 @@ export declare class ToolCallBuilder {
     private _name;
     private _parameters;
     private _type;
+    private _id;
+    /**
+     * Set the sequence number for the tool call.
+     * @param sequence Optional position of the tool call in a batch.
+     * @returns This builder for chaining.
+     */
     sequence(sequence: number | undefined): ToolCallBuilder;
+    /**
+     * Set the name of the tool to invoke.
+     * @param name Tool identifier.
+     * @returns This builder for chaining.
+     */
     name(name: string): this;
+    /**
+     * Provide the argument payload for the tool call.
+     * @param parameters JSON-serializable arguments to pass to the tool.
+     * @returns This builder for chaining.
+     */
     parameters(parameters: any): ToolCallBuilder;
+    /**
+     * Set the type of tool call (e.g., function).
+     * @param type Provider-specific tool call type.
+     * @returns This builder for chaining.
+     */
     type(type: string): ToolCallBuilder;
+    /**
+     * Assign the provider tool call identifier for correlation.
+     * @param id Unique identifier returned by the model.
+     * @returns This builder for chaining.
+     */
+    id(id: string | undefined): ToolCallBuilder;
+    /**
+     * Build the ToolCall with collected data, defaulting sequence to 0.
+     * @returns ToolCall instance ready to attach to a message.
+     */
     build(): ToolCall;
 }
+/**
+ * Error thrown when a requested tool cannot be found on the agent.
+ */
+export declare class ToolNotFoundError extends Error {
+    constructor(message: string);
+}

package/dist/tool/toolschema.d.ts

@@ -25,15 +25,18 @@ export declare class ToolSchemaBuilder {
     /**
      * Add a parameter definition to the schema.
      * @param parameter Fully constructed parameter to append.
+     * @returns This builder for chaining.
      */
     addParameter(parameter: Parameter): ToolSchemaBuilder;
     /**
      * Describe the output of the tool.
      * @param output Text description of what the tool returns.
+     * @returns This builder for chaining.
      */
     output(output: string): ToolSchemaBuilder;
     /**
      * Build the ToolSchema instance from the collected fields.
+     * @returns Constructed ToolSchema describing parameters and output.
      */
     build(): ToolSchema;
 }
@@ -61,8 +64,15 @@ export declare class Parameter {
      * Placeholder for validating supported parameter types.
      */
     assertValidType(): void;
+    /**
+     * Create a builder for constructing a Parameter.
+     * @returns A ParameterBuilder instance.
+     */
     static builder(): ParameterBuilder;
 }
+/**
+ * Builder for defining tool parameters step by step.
+ */
 export declare class ParameterBuilder {
     private _name;
     private _description;
@@ -70,22 +80,27 @@ export declare class ParameterBuilder {
     private _required?;
     /**
      * Set the parameter name.
+     * @returns This builder for chaining.
      */
     name(name: string): ParameterBuilder;
     /**
      * Set the parameter description.
+     * @returns This builder for chaining.
      */
     description(description: string): ParameterBuilder;
     /**
      * Set the parameter type.
+     * @returns This builder for chaining.
      */
     type(type: string): ParameterBuilder;
     /**
      * Mark the parameter as required or optional.
+     * @returns This builder for chaining.
      */
     required(required: boolean): ParameterBuilder;
     /**
      * Build a Parameter instance using the accumulated fields.
+     * @returns Constructed Parameter definition.
      */
     build(): Parameter;
 }

package/package.json

@@ -1,24 +1,27 @@
 {
   "name": "@atgs/tapeworm",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "type": "module",
   "main": "dist/tapeworm.cjs.js",
   "module": "dist/tapeworm.es.js",
   "browser": "dist/tapeworm.umd.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
-    "build": "vite build && npm run build:types",
+    "build": "npm run format && npm run test && vite build && npm run build:types",
     "build:types": "tsc -p tsconfig.types.json",
-    "test": "jest"
+    "test": "jest",
+    "format": "prettier --write \"**/*.{ts,tsx,js,jsx,json,css,md}\""
   },
   "devDependencies": {
     "@babel/preset-env": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
     "@types/jest": "^30.0.0",
     "jest": "^30.2.0",
+    "prettier": "^3.7.4",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.3",
     "vite": "^7.2.7"