@copilotkit/react-core 0.2.0 → 0.3.0

package/.turbo/turbo-build.log

@@ -1,19 +1,19 @@
 
-> @copilotkit/react-core@0.1.0 build /Users/ataibarkai/LocalGit/Recursively.ai/CopilotKit2/packages/react-core
-> tsup --format cjs --dts
+> @copilotkit/react-core@0.2.0 build /Users/ataibarkai/LocalGit/Recursively.ai/CopilotKit2/packages/react-core
+> tsup src/index.tsx --format esm,cjs --dts --external react
 
-CLI Building entry: src/hook.tsx, src/index.tsx
+CLI Building entry: src/index.tsx
 CLI Using tsconfig: tsconfig.json
 CLI tsup v6.5.0
 CLI Using tsup config: /Users/ataibarkai/LocalGit/Recursively.ai/CopilotKit2/packages/react-core/tsup.config.ts
 CLI Target: es6
 CLI Cleaning output folder
+ESM Build start
 CJS Build start
-CJS dist/chunk-KFCOT2YX.js 531.00 B
-CJS dist/hook.js           190.00 B
-CJS dist/index.js          190.00 B
-CJS ⚡️ Build success in 21ms
+ESM dist/index.mjs 5.46 KB
+ESM ⚡️ Build success in 61ms
+CJS dist/index.js 5.50 KB
+CJS ⚡️ Build success in 61ms
 DTS Build start
-DTS ⚡️ Build success in 284ms
-DTS dist/hook.d.ts  57.00 B
-DTS dist/index.d.ts 38.00 B
+DTS ⚡️ Build success in 484ms
+DTS dist/index.d.ts 2.31 KB

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # ui
 
+## 0.3.0
+
+### Minor Changes
+
+- working version
+- 9d2f3cb: semi compiling
+
 ## 0.2.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -1 +1,55 @@
-export { useTurbo } from './hook.js';
+import React$1, { ReactNode } from 'react';
+import { ChatCompletionFunctions } from 'openai-edge/types/api';
+import { FunctionCallHandler, UseChatOptions, Message, CreateMessage, ChatRequestOptions } from 'ai';
+
+declare function CopilotProvider({ children }: {
+    children: ReactNode;
+}): JSX.Element;
+
+interface AnnotatedFunctionArgument {
+    name: string;
+    type: string;
+    description: string;
+    allowedValues?: any[];
+    required: boolean;
+}
+interface AnnotatedFunction<Inputs extends any[]> {
+    name: string;
+    description: string;
+    argumentAnnotations: AnnotatedFunctionArgument[];
+    implementation: (...args: Inputs) => Promise<void>;
+}
+
+type TreeNodeId = string;
+
+interface CopilotContextParams {
+    entryPoints: Record<string, AnnotatedFunction<any[]>>;
+    getChatCompletionFunctions: () => ChatCompletionFunctions[];
+    getFunctionCallHandler: () => FunctionCallHandler;
+    setEntryPoint: (id: string, entryPoint: AnnotatedFunction<any[]>) => void;
+    removeEntryPoint: (id: string) => void;
+    getContextString: () => string;
+    addContext: (context: string, parentId?: string) => TreeNodeId;
+    removeContext: (id: TreeNodeId) => void;
+}
+declare const CopilotContext: React$1.Context<CopilotContextParams>;
+
+interface UseCopilotChatOptions extends UseChatOptions {
+    makeSystemMessage?: (contextString: string) => string;
+}
+interface UseCopilotChatReturn {
+    visibleMessages: Message[];
+    append: (message: Message | CreateMessage, chatRequestOptions?: ChatRequestOptions) => Promise<string | null | undefined>;
+    reload: (chatRequestOptions?: ChatRequestOptions) => Promise<string | null | undefined>;
+    stop: () => void;
+    isLoading: boolean;
+    input: string;
+    setInput: React.Dispatch<React.SetStateAction<string>>;
+}
+declare function useCopilotChat({ makeSystemMessage, ...options }: UseCopilotChatOptions): UseCopilotChatReturn;
+
+declare function useMakeCopilotActionable<ActionInput extends any[]>(annotatedFunction: AnnotatedFunction<ActionInput>, dependencies: any[]): void;
+
+declare function useMakeCopilotReadable(information: string, parentId?: string): string | undefined;
+
+export { AnnotatedFunction, AnnotatedFunctionArgument, CopilotContext, CopilotContextParams, CopilotProvider, UseCopilotChatOptions, UseCopilotChatReturn, useCopilotChat, useMakeCopilotActionable, useMakeCopilotReadable };

package/dist/index.js

@@ -1,10 +1,32 @@
 'use strict';
 
-var chunkKFCOT2YX_js = require('./chunk-KFCOT2YX.js');
+var V = require('react');
+var nanoid = require('nanoid');
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('ai/react');
 
+var k=Object.defineProperty,q=Object.defineProperties;var U=Object.getOwnPropertyDescriptors;var x=Object.getOwnPropertySymbols;var P=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable;var N=(e,t,n)=>t in e?k(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n,h=(e,t)=>{for(var n in t||(t={}))P.call(t,n)&&N(e,n,t[n]);if(x)for(var n of x(t))A.call(t,n)&&N(e,n,t[n]);return e},T=(e,t)=>q(e,U(t));var E=(e,t)=>{var n={};for(var o in e)P.call(e,o)&&t.indexOf(o)<0&&(n[o]=e[o]);if(e!=null&&x)for(var o of x(e))t.indexOf(o)<0&&A.call(e,o)&&(n[o]=e[o]);return n};var v=(e,t,n)=>new Promise((o,r)=>{var i=u=>{try{a(n.next(u));}catch(c){r(c);}},s=u=>{try{a(n.throw(u));}catch(c){r(c);}},a=u=>u.done?o(u.value):Promise.resolve(u.value).then(i,s);a((n=n.apply(e,t)).next());});var I=(e,t)=>{for(let n of e){if(n.id===t)return n;let o=I(n.children,t);if(o)return o}},M=(e,t)=>e.reduce((n,o)=>{if(o.id!==t){let r=T(h({},o),{children:M(o.children,t)});n.push(r);}return n},[]),b=(e,t)=>{if(t===0)return (e+1).toString();if(t===1)return String.fromCharCode(65+e);if(t===2)return String.fromCharCode(97+e);throw new Error("Indentation level not supported")},O=(e,t="",n=0)=>{let o=" ".repeat(3).repeat(n),r=t.length+o.length,i=" ".repeat(r),s=e.value.split(`
+`),a=`${o}${t}${s[0]}`,u=s.slice(1).map(l=>`${i}${l}`).join(`
+`),c=`${a}
+`;return u&&(c+=`${u}
+`),e.children.forEach((l,g)=>c+=O(l,`${t}${b(g,n+1)}. `,n+1)),c};function j(e,t){switch(t.type){case"ADD_NODE":{let{value:n,parentId:o,id:r}=t,i={id:r,value:n,children:[]};if(o){let s=I(e,o);if(s)i.parentId=o,s.children.push(i);else throw new Error(`Parent with id ${o} not found`)}else return [...e,i];return e}case"REMOVE_NODE":return M(e,t.id);default:return e}}var L=()=>{let[e,t]=V.useReducer(j,[]),n=V.useCallback((i,s)=>{let a=nanoid.nanoid();return t({type:"ADD_NODE",value:i,parentId:s,id:a}),a},[]),o=V.useCallback(i=>{t({type:"REMOVE_NODE",id:i});},[]);return {tree:e,addElement:n,printTree:()=>{let i="";return e.forEach((s,a)=>i+=O(s,`${b(a,0)}. `)),i},removeElement:o}},w=L;var J={entryPoints:{},getChatCompletionFunctions:()=>[],getFunctionCallHandler:()=>()=>v(void 0,null,function*(){}),setEntryPoint:()=>{},removeEntryPoint:()=>{},getContextString:()=>"",addContext:()=>"",removeContext:()=>{}},d=V.createContext(J);function B({children:e}){let[t,n]=V.useState({}),{addElement:o,removeElement:r,printTree:i}=w(),s=V.useCallback((p,m)=>{n(C=>T(h({},C),{[p]:m}));},[]),a=V.useCallback(p=>{n(m=>{let C=h({},m);return delete C[p],C});},[]),u=V.useCallback(()=>i(),[i]),c=V.useCallback((p,m)=>o(p,m),[o]),l=V.useCallback(p=>{r(p);},[r]),g=V.useCallback(()=>X(Object.values(t)),[t]),F=V.useCallback(()=>W(Object.values(t)),[t]);return jsxRuntime.jsx(d.Provider,{value:{entryPoints:t,getChatCompletionFunctions:g,getFunctionCallHandler:F,setEntryPoint:s,removeEntryPoint:a,getContextString:u,addContext:c,removeContext:l},children:e})}function W(e){return (t,n)=>v(this,null,function*(){let o={};for(let i of e)o[i.name]=i;let r=o[n.name||""];if(r){let i=[];n.arguments&&(i=JSON.parse(n.arguments));let s=[];for(let a of r.argumentAnnotations)s.push(i[a.name]);yield r.implementation(...s);}})}function X(e){return e.map(Y)}function Y(e){let t={};for(let r of e.argumentAnnotations)t[r.name]={type:r.type,description:r.description};let n=[];for(let r of e.argumentAnnotations)r.required&&n.push(r.name);return {name:e.name,description:e.description,parameters:{type:"object",properties:t,required:n}}}function Z(n){var o=n,{makeSystemMessage:e}=o,t=E(o,["makeSystemMessage"]);let{getContextString:r,getChatCompletionFunctions:i,getFunctionCallHandler:s}=V.useContext(d),u=[V.useMemo(()=>{let y=e||te,$=r();return {id:"system",content:y($),role:"system"}},[r,e])].concat(t.initialMessages||[]),c=V.useMemo(()=>i(),[i]),{messages:l,append:g,reload:F,stop:p,isLoading:m,input:C,setInput:D}=react.useChat({id:t.id,initialMessages:u,experimental_onFunctionCall:s(),body:{id:t.id,previewToken:ee,functions:c}});return {visibleMessages:l.filter(y=>y.role==="user"||y.role==="assistant"),append:g,reload:F,stop:p,isLoading:m,input:C,setInput:D}}var ee="TODO123";function te(e){return `
+Please act as a efficient, competent, and conscientious professional assistant.
+You help the user achieve their goals, and you do so in a way that is as efficient as possible, without unnecessary fluff, but also without sacrificing professionalism.
+Always be polite and respectful, and prefer brevity over verbosity.
 
+The user has provided you with the following context:
+\`\`\`
+${e}
+\`\`\`
 
-Object.defineProperty(exports, 'useTurbo', {
-	enumerable: true,
-	get: function () { return chunkKFCOT2YX_js.a; }
-});
+They have also provided you with functions you can call to initiate actions on their behalf, or functions you can call to receive more information.
+
+Please assist them as best you can.
+If you are not sure how to proceed to best fulfill their requests, please ask them for more information.
+`}function ae(e,t){let n=V.useRef(nanoid.nanoid()),{setEntryPoint:o,removeEntryPoint:r}=V.useContext(d),i=V.useMemo(()=>({name:e.name,description:e.description,argumentAnnotations:e.argumentAnnotations,implementation:e.implementation}),t);V.useEffect(()=>(o(n.current,i),()=>{r(n.current);}),[i,o,r]);}function de(e,t){let{addContext:n,removeContext:o}=V.useContext(d),r=V.useRef();return V.useEffect(()=>{let i=n(e,t);return r.current=i,()=>{o(i);}},[e,t,n,o]),r.current}
+
+exports.CopilotContext = d;
+exports.CopilotProvider = B;
+exports.useCopilotChat = Z;
+exports.useMakeCopilotActionable = ae;
+exports.useMakeCopilotReadable = de;

package/dist/index.mjs

@@ -0,0 +1,26 @@
+import V, { useState, useCallback, useContext, useMemo, useRef, useEffect, useReducer } from 'react';
+import { nanoid } from 'nanoid';
+import { jsx } from 'react/jsx-runtime';
+import { useChat } from 'ai/react';
+
+var k=Object.defineProperty,q=Object.defineProperties;var U=Object.getOwnPropertyDescriptors;var x=Object.getOwnPropertySymbols;var P=Object.prototype.hasOwnProperty,A=Object.prototype.propertyIsEnumerable;var N=(e,t,n)=>t in e?k(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n,h=(e,t)=>{for(var n in t||(t={}))P.call(t,n)&&N(e,n,t[n]);if(x)for(var n of x(t))A.call(t,n)&&N(e,n,t[n]);return e},T=(e,t)=>q(e,U(t));var E=(e,t)=>{var n={};for(var o in e)P.call(e,o)&&t.indexOf(o)<0&&(n[o]=e[o]);if(e!=null&&x)for(var o of x(e))t.indexOf(o)<0&&A.call(e,o)&&(n[o]=e[o]);return n};var v=(e,t,n)=>new Promise((o,r)=>{var i=u=>{try{a(n.next(u));}catch(c){r(c);}},s=u=>{try{a(n.throw(u));}catch(c){r(c);}},a=u=>u.done?o(u.value):Promise.resolve(u.value).then(i,s);a((n=n.apply(e,t)).next());});var I=(e,t)=>{for(let n of e){if(n.id===t)return n;let o=I(n.children,t);if(o)return o}},M=(e,t)=>e.reduce((n,o)=>{if(o.id!==t){let r=T(h({},o),{children:M(o.children,t)});n.push(r);}return n},[]),b=(e,t)=>{if(t===0)return (e+1).toString();if(t===1)return String.fromCharCode(65+e);if(t===2)return String.fromCharCode(97+e);throw new Error("Indentation level not supported")},O=(e,t="",n=0)=>{let o=" ".repeat(3).repeat(n),r=t.length+o.length,i=" ".repeat(r),s=e.value.split(`
+`),a=`${o}${t}${s[0]}`,u=s.slice(1).map(l=>`${i}${l}`).join(`
+`),c=`${a}
+`;return u&&(c+=`${u}
+`),e.children.forEach((l,g)=>c+=O(l,`${t}${b(g,n+1)}. `,n+1)),c};function j(e,t){switch(t.type){case"ADD_NODE":{let{value:n,parentId:o,id:r}=t,i={id:r,value:n,children:[]};if(o){let s=I(e,o);if(s)i.parentId=o,s.children.push(i);else throw new Error(`Parent with id ${o} not found`)}else return [...e,i];return e}case"REMOVE_NODE":return M(e,t.id);default:return e}}var L=()=>{let[e,t]=useReducer(j,[]),n=useCallback((i,s)=>{let a=nanoid();return t({type:"ADD_NODE",value:i,parentId:s,id:a}),a},[]),o=useCallback(i=>{t({type:"REMOVE_NODE",id:i});},[]);return {tree:e,addElement:n,printTree:()=>{let i="";return e.forEach((s,a)=>i+=O(s,`${b(a,0)}. `)),i},removeElement:o}},w=L;var J={entryPoints:{},getChatCompletionFunctions:()=>[],getFunctionCallHandler:()=>()=>v(void 0,null,function*(){}),setEntryPoint:()=>{},removeEntryPoint:()=>{},getContextString:()=>"",addContext:()=>"",removeContext:()=>{}},d=V.createContext(J);function B({children:e}){let[t,n]=useState({}),{addElement:o,removeElement:r,printTree:i}=w(),s=useCallback((p,m)=>{n(C=>T(h({},C),{[p]:m}));},[]),a=useCallback(p=>{n(m=>{let C=h({},m);return delete C[p],C});},[]),u=useCallback(()=>i(),[i]),c=useCallback((p,m)=>o(p,m),[o]),l=useCallback(p=>{r(p);},[r]),g=useCallback(()=>X(Object.values(t)),[t]),F=useCallback(()=>W(Object.values(t)),[t]);return jsx(d.Provider,{value:{entryPoints:t,getChatCompletionFunctions:g,getFunctionCallHandler:F,setEntryPoint:s,removeEntryPoint:a,getContextString:u,addContext:c,removeContext:l},children:e})}function W(e){return (t,n)=>v(this,null,function*(){let o={};for(let i of e)o[i.name]=i;let r=o[n.name||""];if(r){let i=[];n.arguments&&(i=JSON.parse(n.arguments));let s=[];for(let a of r.argumentAnnotations)s.push(i[a.name]);yield r.implementation(...s);}})}function X(e){return e.map(Y)}function Y(e){let t={};for(let r of e.argumentAnnotations)t[r.name]={type:r.type,description:r.description};let n=[];for(let r of e.argumentAnnotations)r.required&&n.push(r.name);return {name:e.name,description:e.description,parameters:{type:"object",properties:t,required:n}}}function Z(n){var o=n,{makeSystemMessage:e}=o,t=E(o,["makeSystemMessage"]);let{getContextString:r,getChatCompletionFunctions:i,getFunctionCallHandler:s}=useContext(d),u=[useMemo(()=>{let y=e||te,$=r();return {id:"system",content:y($),role:"system"}},[r,e])].concat(t.initialMessages||[]),c=useMemo(()=>i(),[i]),{messages:l,append:g,reload:F,stop:p,isLoading:m,input:C,setInput:D}=useChat({id:t.id,initialMessages:u,experimental_onFunctionCall:s(),body:{id:t.id,previewToken:ee,functions:c}});return {visibleMessages:l.filter(y=>y.role==="user"||y.role==="assistant"),append:g,reload:F,stop:p,isLoading:m,input:C,setInput:D}}var ee="TODO123";function te(e){return `
+Please act as a efficient, competent, and conscientious professional assistant.
+You help the user achieve their goals, and you do so in a way that is as efficient as possible, without unnecessary fluff, but also without sacrificing professionalism.
+Always be polite and respectful, and prefer brevity over verbosity.
+
+The user has provided you with the following context:
+\`\`\`
+${e}
+\`\`\`
+
+They have also provided you with functions you can call to initiate actions on their behalf, or functions you can call to receive more information.
+
+Please assist them as best you can.
+If you are not sure how to proceed to best fulfill their requests, please ask them for more information.
+`}function ae(e,t){let n=useRef(nanoid()),{setEntryPoint:o,removeEntryPoint:r}=useContext(d),i=useMemo(()=>({name:e.name,description:e.description,argumentAnnotations:e.argumentAnnotations,implementation:e.implementation}),t);useEffect(()=>(o(n.current,i),()=>{r(n.current);}),[i,o,r]);}function de(e,t){let{addContext:n,removeContext:o}=useContext(d),r=useRef();return useEffect(()=>{let i=n(e,t);return r.current=i,()=>{o(i);}},[e,t,n,o]),r.current}
+
+export { d as CopilotContext, B as CopilotProvider, Z as useCopilotChat, ae as useMakeCopilotActionable, de as useMakeCopilotReadable };

package/package.json

@@ -4,15 +4,12 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.2.0",
-  "sideEffects": [
-    "**/*.css"
-  ],
+  "version": "0.3.0",
+  "sideEffects": false,
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "exports": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
-  "exports": {
-    ".": "./dist",
-    "./styles.css": "./dist/index.css"
-  },
   "license": "MIT",
   "peerDependencies": {
     "react": "^18.2.0"
@@ -23,12 +20,18 @@
     "react": "^18.2.0",
     "tsup": "^6.1.3",
     "typescript": "^4.9.4",
-    "eslint-config-custom": "0.0.0",
-    "tsconfig": "0.0.0"
+    "eslint-config-custom": "0.1.0",
+    "tsconfig": "0.1.0"
+  },
+  "dependencies": {
+    "ai": "^2.1.19",
+    "nanoid": "^4.0.2",
+    "openai-edge": "^1.2.0"
   },
   "scripts": {
-    "build": "tsup --format cjs --dts",
-    "dev": "tsup --watch",
-    "check-types": "tsc --noEmit"
+    "build": "tsup src/index.tsx --format esm,cjs --dts --external react",
+    "dev": "tsup src/index.tsx --format esm,cjs --dts --external react --watch",
+    "check-types": "tsc --noEmit",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist && rm -rf .next"
   }
 }

package/src/components/copilot-provider.tsx

@@ -0,0 +1,167 @@
+'use client'
+import React, { useState, ReactNode, useCallback } from 'react'
+import { AnnotatedFunction } from '../types/annotated-function'
+import useTree from '../hooks/use-tree'
+import { CopilotContext } from '../context/copilot-context'
+import { FunctionCallHandler } from 'ai'
+import { ChatCompletionFunctions } from 'openai-edge/types/api'
+
+export function CopilotProvider({
+  children
+}: {
+  children: ReactNode
+}): JSX.Element {
+  const [entryPoints, setEntryPoints] = useState<
+    Record<string, AnnotatedFunction<any[]>>
+  >({})
+
+  const { addElement, removeElement, printTree } = useTree()
+
+  const setEntryPoint = useCallback(
+    (id: string, entryPoint: AnnotatedFunction<any[]>) => {
+      setEntryPoints(prevPoints => {
+        return {
+          ...prevPoints,
+          [id]: entryPoint
+        }
+      })
+    },
+    []
+  )
+
+  const removeEntryPoint = useCallback((id: string) => {
+    setEntryPoints(prevPoints => {
+      const newPoints = { ...prevPoints }
+      delete newPoints[id]
+      return newPoints
+    })
+  }, [])
+
+  const getContextString = useCallback(() => {
+    return printTree()
+  }, [printTree])
+
+  const addContext = useCallback(
+    (context: string, parentId?: string) => {
+      return addElement(context, parentId)
+    },
+    [addElement]
+  )
+
+  const removeContext = useCallback(
+    (id: string) => {
+      removeElement(id)
+    },
+    [removeElement]
+  )
+
+  const getChatCompletionFunctions = useCallback(() => {
+    return entryPointsToChatCompletionFunctions(Object.values(entryPoints))
+  }, [entryPoints])
+
+  const getFunctionCallHandler = useCallback(() => {
+    return entryPointsToFunctionCallHandler(Object.values(entryPoints))
+  }, [entryPoints])
+
+  return (
+    <CopilotContext.Provider
+      value={{
+        entryPoints,
+        getChatCompletionFunctions,
+        getFunctionCallHandler,
+        setEntryPoint,
+        removeEntryPoint,
+        getContextString,
+        addContext,
+        removeContext
+      }}
+    >
+      {children}
+    </CopilotContext.Provider>
+  )
+}
+
+function entryPointsToFunctionCallHandler(
+  entryPoints: AnnotatedFunction<any[]>[]
+): FunctionCallHandler {
+  return async (chatMessages, functionCall) => {
+    let entrypointsByFunctionName: Record<string, AnnotatedFunction<any[]>> = {}
+    for (let entryPoint of entryPoints) {
+      entrypointsByFunctionName[entryPoint.name] = entryPoint
+    }
+
+    const entryPointFunction =
+      entrypointsByFunctionName[functionCall.name || '']
+    if (entryPointFunction) {
+      let parsedFunctionCallArguments: Record<string, any>[] = []
+      if (functionCall.arguments) {
+        parsedFunctionCallArguments = JSON.parse(functionCall.arguments)
+      }
+
+      const paramsInCorrectOrder: any[] = []
+      for (let arg of entryPointFunction.argumentAnnotations) {
+        paramsInCorrectOrder.push(
+          parsedFunctionCallArguments[
+            arg.name as keyof typeof parsedFunctionCallArguments
+          ]
+        )
+      }
+
+      await entryPointFunction.implementation(...paramsInCorrectOrder)
+
+      // commented out becasue for now we don't want to return anything
+      // const result = await entryPointFunction.implementation(
+      //   ...parsedFunctionCallArguments
+      // );
+      // const functionResponse: ChatRequest = {
+      //   messages: [
+      //     ...chatMessages,
+      //     {
+      //       id: nanoid(),
+      //       name: functionCall.name,
+      //       role: 'function' as const,
+      //       content: JSON.stringify(result),
+      //     },
+      //   ],
+      // };
+
+      // return functionResponse;
+    }
+  }
+}
+
+function entryPointsToChatCompletionFunctions(
+  entryPoints: AnnotatedFunction<any[]>[]
+): ChatCompletionFunctions[] {
+  return entryPoints.map(annotatedFunctionToChatCompletionFunction)
+}
+
+function annotatedFunctionToChatCompletionFunction(
+  annotatedFunction: AnnotatedFunction<any[]>
+): ChatCompletionFunctions {
+  // Create the parameters object based on the argumentAnnotations
+  let parameters: { [key: string]: any } = {}
+  for (let arg of annotatedFunction.argumentAnnotations) {
+    parameters[arg.name] = { type: arg.type, description: arg.description }
+  }
+
+  let requiredParameterNames: string[] = []
+  for (let arg of annotatedFunction.argumentAnnotations) {
+    if (arg.required) {
+      requiredParameterNames.push(arg.name)
+    }
+  }
+
+  // Create the ChatCompletionFunctions object
+  let chatCompletionFunction: ChatCompletionFunctions = {
+    name: annotatedFunction.name,
+    description: annotatedFunction.description,
+    parameters: {
+      type: 'object',
+      properties: parameters,
+      required: requiredParameterNames
+    }
+  }
+
+  return chatCompletionFunction
+}

package/src/components/index.ts

@@ -0,0 +1 @@
+export { CopilotProvider } from './copilot-provider'

package/src/context/copilot-context.tsx

@@ -0,0 +1,33 @@
+'use client'
+
+import React from 'react'
+import { AnnotatedFunction } from '../types/annotated-function'
+import { TreeNodeId } from '../hooks/use-tree'
+import { ChatCompletionFunctions } from 'openai-edge/types/api'
+import { FunctionCallHandler } from 'ai'
+
+export interface CopilotContextParams {
+  entryPoints: Record<string, AnnotatedFunction<any[]>>
+  getChatCompletionFunctions: () => ChatCompletionFunctions[]
+  getFunctionCallHandler: () => FunctionCallHandler
+  setEntryPoint: (id: string, entryPoint: AnnotatedFunction<any[]>) => void
+  removeEntryPoint: (id: string) => void
+
+  getContextString: () => string
+  addContext: (context: string, parentId?: string) => TreeNodeId
+  removeContext: (id: TreeNodeId) => void
+}
+
+const emptyCopilotContext: CopilotContextParams = {
+  entryPoints: {},
+  getChatCompletionFunctions: () => [],
+  getFunctionCallHandler: () => async () => {},
+  setEntryPoint: () => {},
+  removeEntryPoint: () => {},
+  getContextString: () => '',
+  addContext: () => '',
+  removeContext: () => {}
+}
+
+export const CopilotContext =
+  React.createContext<CopilotContextParams>(emptyCopilotContext)

package/src/context/index.ts

@@ -0,0 +1,2 @@
+export { CopilotContext } from './copilot-context'
+export type { CopilotContextParams } from './copilot-context'

package/src/hooks/index.ts

@@ -0,0 +1,6 @@
+export { useCopilotChat } from './use-copilot-chat'
+export type { UseCopilotChatOptions } from './use-copilot-chat'
+export type { UseCopilotChatReturn } from './use-copilot-chat'
+
+export { useMakeCopilotActionable } from './use-make-copilot-actionable'
+export { useMakeCopilotReadable } from './use-make-copilot-readable'

package/src/hooks/use-copilot-chat.ts

@@ -0,0 +1,103 @@
+import { useMemo, useContext } from 'react'
+import {
+  CopilotContext,
+  CopilotContextParams
+} from '../context/copilot-context'
+import { useChat } from 'ai/react'
+import { ChatRequestOptions, CreateMessage, Message } from 'ai'
+import { UseChatOptions } from 'ai'
+
+export interface UseCopilotChatOptions extends UseChatOptions {
+  makeSystemMessage?: (contextString: string) => string
+}
+
+export interface UseCopilotChatReturn {
+  visibleMessages: Message[]
+  append: (
+    message: Message | CreateMessage,
+    chatRequestOptions?: ChatRequestOptions
+  ) => Promise<string | null | undefined>
+  reload: (
+    chatRequestOptions?: ChatRequestOptions
+  ) => Promise<string | null | undefined>
+  stop: () => void
+  isLoading: boolean
+  input: string
+  setInput: React.Dispatch<React.SetStateAction<string>>
+}
+
+export function useCopilotChat({
+  makeSystemMessage,
+  ...options
+}: UseCopilotChatOptions): UseCopilotChatReturn {
+  const {
+    getContextString,
+    getChatCompletionFunctions,
+    getFunctionCallHandler
+  } = useContext(CopilotContext)
+
+  const systemMessage: Message = useMemo(() => {
+    const systemMessageMaker = makeSystemMessage || defaultSystemMessage
+    const contextString = getContextString()
+
+    return {
+      id: 'system',
+      content: systemMessageMaker(contextString),
+      role: 'system'
+    }
+  }, [getContextString, makeSystemMessage])
+
+  const initialMessagesWithContext = [systemMessage].concat(
+    options.initialMessages || []
+  )
+
+  const functions = useMemo(() => {
+    return getChatCompletionFunctions()
+  }, [getChatCompletionFunctions])
+
+  const { messages, append, reload, stop, isLoading, input, setInput } =
+    useChat({
+      id: options.id,
+      initialMessages: initialMessagesWithContext,
+      experimental_onFunctionCall: getFunctionCallHandler(),
+      body: {
+        id: options.id,
+        previewToken,
+        functions
+      }
+    })
+
+  const visibleMessages = messages.filter(
+    message => message.role === 'user' || message.role === 'assistant'
+  )
+
+  return {
+    visibleMessages,
+    append,
+    reload,
+    stop,
+    isLoading,
+    input,
+    setInput
+  }
+}
+
+const previewToken = 'TODO123'
+
+export function defaultSystemMessage(contextString: string): string {
+  return `
+Please act as a efficient, competent, and conscientious professional assistant.
+You help the user achieve their goals, and you do so in a way that is as efficient as possible, without unnecessary fluff, but also without sacrificing professionalism.
+Always be polite and respectful, and prefer brevity over verbosity.
+
+The user has provided you with the following context:
+\`\`\`
+${contextString}
+\`\`\`
+
+They have also provided you with functions you can call to initiate actions on their behalf, or functions you can call to receive more information.
+
+Please assist them as best you can.
+If you are not sure how to proceed to best fulfill their requests, please ask them for more information.
+`
+}

package/src/hooks/use-make-copilot-actionable.ts

@@ -0,0 +1,35 @@
+'use client'
+
+import { useRef, useContext, useEffect, useMemo } from 'react'
+import { CopilotContext } from '../context/copilot-context'
+import { AnnotatedFunction } from '../types/annotated-function'
+import { nanoid } from 'nanoid'
+
+export function useMakeCopilotActionable<ActionInput extends any[]>(
+  annotatedFunction: AnnotatedFunction<ActionInput>,
+  dependencies: any[]
+) {
+  const idRef = useRef(nanoid()) // generate a unique id
+  const { setEntryPoint, removeEntryPoint } = useContext(CopilotContext)
+
+  const memoizedAnnotatedFunction: AnnotatedFunction<ActionInput> = useMemo(
+    () => ({
+      name: annotatedFunction.name,
+      description: annotatedFunction.description,
+      argumentAnnotations: annotatedFunction.argumentAnnotations,
+      implementation: annotatedFunction.implementation
+    }),
+    dependencies
+  )
+
+  useEffect(() => {
+    setEntryPoint(
+      idRef.current,
+      memoizedAnnotatedFunction as AnnotatedFunction<any[]>
+    )
+
+    return () => {
+      removeEntryPoint(idRef.current)
+    }
+  }, [memoizedAnnotatedFunction, setEntryPoint, removeEntryPoint])
+}

package/src/hooks/use-make-copilot-readable.ts

@@ -0,0 +1,23 @@
+'use client'
+
+import { useRef, useContext, useEffect } from 'react'
+import { CopilotContext } from '../context/copilot-context'
+
+export function useMakeCopilotReadable(
+  information: string,
+  parentId?: string
+): string | undefined {
+  const { addContext, removeContext } = useContext(CopilotContext)
+  const idRef = useRef<string>()
+
+  useEffect(() => {
+    const id = addContext(information, parentId)
+    idRef.current = id
+
+    return () => {
+      removeContext(id)
+    }
+  }, [information, parentId, addContext, removeContext])
+
+  return idRef.current
+}

package/src/hooks/use-tree.ts

@@ -0,0 +1,159 @@
+import { nanoid } from 'nanoid'
+import { useReducer, useCallback } from 'react'
+
+export type TreeNodeId = string
+
+export interface TreeNode {
+  id: TreeNodeId
+  value: string
+  children: TreeNode[]
+  parentId?: TreeNodeId
+}
+
+export type Tree = TreeNode[]
+
+export interface UseTreeReturn {
+  tree: Tree
+  addElement: (value: string, parentId?: TreeNodeId) => TreeNodeId
+  printTree: () => string
+  removeElement: (id: TreeNodeId) => void
+}
+
+const findNode = (nodes: Tree, id: TreeNodeId): TreeNode | undefined => {
+  for (const node of nodes) {
+    if (node.id === id) {
+      return node
+    }
+    const result = findNode(node.children, id)
+    if (result) {
+      return result
+    }
+  }
+  return undefined
+}
+
+const removeNode = (nodes: Tree, id: TreeNodeId): Tree => {
+  return nodes.reduce((result: Tree, node) => {
+    if (node.id !== id) {
+      const newNode = { ...node, children: removeNode(node.children, id) }
+      result.push(newNode)
+    }
+    return result
+  }, [])
+}
+
+const treeIndentationRepresentation = (
+  index: number,
+  indentLevel: number
+): string => {
+  if (indentLevel === 0) {
+    return (index + 1).toString()
+  } else if (indentLevel === 1) {
+    return String.fromCharCode(65 + index) // 65 is the ASCII value for 'A'
+  } else if (indentLevel === 2) {
+    return String.fromCharCode(97 + index) // 97 is the ASCII value for 'a'
+  } else {
+    throw new Error('Indentation level not supported')
+  }
+}
+
+const printNode = (node: TreeNode, prefix = '', indentLevel = 0): string => {
+  const indent = ' '.repeat(3).repeat(indentLevel)
+
+  const prefixPlusIndentLength = prefix.length + indent.length
+  const subsequentLinesPrefix = ' '.repeat(prefixPlusIndentLength)
+
+  const valueLines = node.value.split('\n')
+
+  const outputFirstLine = `${indent}${prefix}${valueLines[0]}`
+  const outputSubsequentLines = valueLines
+    .slice(1)
+    .map(line => `${subsequentLinesPrefix}${line}`)
+    .join('\n')
+
+  let output = `${outputFirstLine}\n`
+  if (outputSubsequentLines) {
+    output += `${outputSubsequentLines}\n`
+  }
+
+  node.children.forEach(
+    (child, index) =>
+      (output += printNode(
+        child,
+        `${prefix}${treeIndentationRepresentation(index, indentLevel + 1)}. `,
+        indentLevel + 1
+      ))
+  )
+  return output
+}
+
+// Action types
+type Action =
+  | { type: 'ADD_NODE'; value: string; parentId?: string; id: string }
+  | { type: 'REMOVE_NODE'; id: string }
+
+// Reducer function
+function treeReducer(state: Tree, action: Action): Tree {
+  switch (action.type) {
+    case 'ADD_NODE': {
+      const { value, parentId, id: newNodeId } = action
+      const newNode: TreeNode = {
+        id: newNodeId,
+        value,
+        children: []
+      }
+
+      if (parentId) {
+        const parent = findNode(state, parentId)
+        if (parent) {
+          newNode.parentId = parentId
+          parent.children.push(newNode)
+        } else {
+          throw new Error(`Parent with id ${parentId} not found`)
+        }
+      } else {
+        return [...state, newNode]
+      }
+
+      return state
+    }
+    case 'REMOVE_NODE':
+      return removeNode(state, action.id)
+    default:
+      return state
+  }
+}
+
+// useTree hook
+const useTree = (): UseTreeReturn => {
+  const [tree, dispatch] = useReducer(treeReducer, [])
+
+  const addElement = useCallback(
+    (value: string, parentId?: string): TreeNodeId => {
+      const newNodeId = nanoid() // Generate new ID outside of dispatch
+      dispatch({ type: 'ADD_NODE', value, parentId, id: newNodeId })
+      return newNodeId // Return the new ID
+    },
+    []
+  )
+
+  const removeElement = useCallback((id: TreeNodeId): void => {
+    dispatch({ type: 'REMOVE_NODE', id })
+  }, [])
+
+  const printTree = (): string => {
+    let output = ''
+    tree.forEach(
+      (node, index) =>
+        (output += printNode(
+          node,
+          `${treeIndentationRepresentation(index, 0)}. `
+        ))
+    )
+    return output
+  }
+
+  return { tree, addElement, printTree, removeElement }
+}
+
+export default useTree

package/src/index.tsx

@@ -1,2 +1,4 @@
-// components
-export * from "./hook";
+export * from './components'
+export * from './context'
+export * from './hooks'
+export * from './types'

package/src/types/annotated-function.ts

@@ -0,0 +1,14 @@
+export interface AnnotatedFunctionArgument {
+  name: string
+  type: string
+  description: string
+  allowedValues?: any[]
+  required: boolean
+}
+
+export interface AnnotatedFunction<Inputs extends any[]> {
+  name: string
+  description: string
+  argumentAnnotations: AnnotatedFunctionArgument[]
+  implementation: (...args: Inputs) => Promise<void>
+}

package/src/types/index.ts

@@ -0,0 +1,2 @@
+export type { AnnotatedFunctionArgument } from './annotated-function'
+export type { AnnotatedFunction } from './annotated-function'

package/tsup.config.ts

@@ -11,3 +11,4 @@ export default defineConfig((options: Options) => ({
   external: ["react"],
   ...options,
 }));
+

package/dist/chunk-KFCOT2YX.js

@@ -1,26 +0,0 @@
-'use strict';
-
-var t = require('react');
-
-function _interopNamespaceDefault(e) {
-	var n = Object.create(null);
-	if (e) {
-		Object.keys(e).forEach(function (k) {
-			if (k !== 'default') {
-				var d = Object.getOwnPropertyDescriptor(e, k);
-				Object.defineProperty(n, k, d.get ? d : {
-					enumerable: true,
-					get: function () { return e[k]; }
-				});
-			}
-		});
-	}
-	n.default = e;
-	return Object.freeze(n);
-}
-
-var t__namespace = /*#__PURE__*/_interopNamespaceDefault(t);
-
-function u(){t__namespace.useState(0);}
-
-exports.a = u;

package/dist/hook.d.ts

@@ -1,3 +0,0 @@
-declare function useTurbo(): void;
-
-export { useTurbo };

package/dist/hook.js

@@ -1,10 +0,0 @@
-'use strict';
-
-var chunkKFCOT2YX_js = require('./chunk-KFCOT2YX.js');
-
-
-
-Object.defineProperty(exports, 'useTurbo', {
-	enumerable: true,
-	get: function () { return chunkKFCOT2YX_js.a; }
-});

package/src/hook.tsx

@@ -1,5 +0,0 @@
-import * as React from "react";
-
-export function useTurbo() {
-  const [num, setNum] = React.useState(0);
-}