Migrate to laravel ai sdk (#181)

Also * upgrade to livewire 4 * replace rappsoft tables with filament
2026-03-13 15:21:22 -05:00
parent fc6b7a8c52
commit 66889abc72
57 changed files with 4064 additions and 1761 deletions
@@ -0,0 +1,66 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Ai\Agents;
+
+use App\Models\Holding;
+use Laravel\Ai\Concerns\RemembersConversations;
+use Laravel\Ai\Contracts\Agent;
+use Laravel\Ai\Contracts\Conversational;
+use Laravel\Ai\Contracts\HasTools;
+use Laravel\Ai\Contracts\Tool;
+use Laravel\Ai\Promptable;
+use Stringable;
+
+class ChatWithHoldingAgent implements Agent, Conversational, HasTools
+{
+    use Promptable;
+    use RemembersConversations;
+
+    public function __construct(public readonly Holding $holding) {}
+
+    /**
+     * Get the instructions that the agent should follow.
+     */
+    public function instructions(): Stringable|string
+    {
+        $holding = $this->holding;
+        $quantity = $holding->quantity > 0
+            ? 'a total of '.$holding->quantity
+            : 'ZERO';
+
+        return 'Most recent training data: '.now()->toDateString().'.
+
+You are an investment portfolio assistant providing advice to an investor. Use the following information to provide relevant recommendations. Use the words \'likely\' or \'may\' instead of concrete statements (except for obvious statements of fact or common sense). Do not apologize. Be polite, but minimize gratuitous niceties. If something is unclear, ask for clarification. When referencing numbers with precision, always round to the nearest 100th decimal place. If no precision, display numbers in integers.
+
+The investor owns '.$quantity.' shares of '.$holding->market_data->name.' (ticker: '.$holding->symbol.') with an average cost basis of '.$holding->average_cost_basis.'. Here are the relevant transactions - sales and purchases of '.$holding->symbol.':
+
+'.$holding->getFormattedTransactions().'
+
+This investor has earned $ '.$holding->dividends_earned.' in dividends so far and earned '.$holding->realized_gains_dollars.' in realized gains (sales) from '.$holding->symbol.' in this portfolio.
+
+The current market price for '.$holding->symbol.' is '.$holding->market_data->market_value.'. Additionally, here\'s other critical fundamentals for '.$holding->market_data->name.' that might help:
+ * Market cap: '.$holding->market_data->market_cap.'
+ * Forward PE: '.$holding->market_data->forward_pe.'
+ * Trailing PE: '.$holding->market_data->trailing_pe.'
+ * Book value: '.$holding->market_data->book_value.'
+ * 52 week low: '.$holding->market_data->fifty_two_week_low.'
+ * 52 week high: '.$holding->market_data->fifty_two_week_high.'
+ * Dividend yield: '.$holding->market_data->dividend_yield.'
+
+Based on this current market data, quantity owned, and average cost basis, you should determine if the '.$holding->symbol.' holding is making or losing money.
+
+Below is the question from the investor. Considering these facts, provide a concise response to the following question (give a direct response). Limit your response to no more than 75 words and consider using a common decision framework. Use github style markdown for any formatting:';
+    }
+
+    /**
+     * Get the tools available to the agent.
+     *
+     * @return Tool[]
+     */
+    public function tools(): iterable
+    {
+        return [];
+    }
+}
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Ai\Agents;
+
+use App\Models\Portfolio;
+use Laravel\Ai\Concerns\RemembersConversations;
+use Laravel\Ai\Contracts\Agent;
+use Laravel\Ai\Contracts\Conversational;
+use Laravel\Ai\Contracts\HasTools;
+use Laravel\Ai\Contracts\Tool;
+use Laravel\Ai\Promptable;
+use Stringable;
+
+class ChatWithPortfolioAgent implements Agent, Conversational, HasTools
+{
+    use Promptable;
+    use RemembersConversations;
+
+    public function __construct(public readonly Portfolio $portfolio) {}
+
+    /**
+     * Get the instructions that the agent should follow.
+     */
+    public function instructions(): Stringable|string
+    {
+        return 'Most recent training data: '.now()->toDateString().'.
+
+You are an investment portfolio assistant providing advice to an investor. Use the following information to provide relevant recommendations. Use the words \'likely\' or \'may\' in lieu of concrete statements (except for obvious statements of fact or common sense). Do not apologize. Be polite, but minimize gratuitous niceties. When referencing numbers with precision, always round to the nearest 100th decimal place. If no precision, display numbers in integers.
+
+The investor has the following holdings in this portfolio:
+
+'.$this->portfolio->getFormattedHoldings().'
+
+Based on the current market data, quantity owned, and average cost basis, you can determine the performance of any holding.
+
+Below is the question from the investor. Considering these facts, provide a concise response to the following question (give a direct response). Limit your response to no more than 75 words and consider using a common decision framework. Use github style markdown for any formatting:';
+    }
+
+    /**
+     * Get the tools available to the agent.
+     *
+     * @return Tool[]
+     */
+    public function tools(): iterable
+    {
+        return [];
+    }
+}
@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Ai\Agents;
+
+use Illuminate\Contracts\JsonSchema\JsonSchema;
+use Laravel\Ai\Contracts\Agent;
+use Laravel\Ai\Contracts\HasStructuredOutput;
+use Laravel\Ai\Contracts\HasTools;
+use Laravel\Ai\Contracts\Messages;
+use Laravel\Ai\Contracts\Tool;
+use Laravel\Ai\Promptable;
+use Stringable;
+
+class ChatWithSuggestedPromptsAgent implements Agent, HasStructuredOutput, HasTools
+{
+    use Promptable;
+
+    public function __construct(
+        public array $messages
+    ) {}
+
+    /**
+     * Get the instructions that the agent should follow.
+     */
+    public function instructions(): Stringable|string
+    {
+        return 'Your role is a savvy helper that assists curious investors in asking thoughtful questions to investment advisors.
+
+You should recommend between 1 and 5 (no more than 5) questions. You should ensure the questions you recommend are based on the provided context. Be sure to keep the questions short!
+
+The questions you recommend might be based on natural follow up from the given context, requests to further refine a previous response, clarify undefined terms, common decision frameworks, possible risks or benefits, or commonly understood investing concepts that may require additional explanation.
+
+Generate between 1 and 5 (no more than 5) follow up questions a curious investor might ask their advisor based on the provided conversation.';
+    }
+
+    /**
+     * Get the tools available to the agent.
+     *
+     * @return Tool[]
+     */
+    public function tools(): iterable
+    {
+        return [];
+    }
+
+    /**
+     * Get the messages available to the agent.
+     *
+     * @return Messages[]
+     */
+    public function messages(): iterable
+    {
+        return $this->messages;
+    }
+
+    /**
+     * Get the agent's structured output schema definition.
+     */
+    public function schema(JsonSchema $schema): array
+    {
+        return [
+            'suggested_prompts' => $schema->array()->items(
+                $schema->object([
+                    'text' => $schema->string()
+                        ->description('Short description of suggested prompt (no more than 5 words)')
+                        ->required(),
+                    'value' => $schema->string()
+                        ->description('The detailed version of the prompt (think good prompt engineering!)')
+                        ->required(),
+                ])->withoutAdditionalProperties()
+            )->required(),
+        ];
+    }
+}