oysterun 1.5.3-beta.2 → 1.5.3

package/README.md

@@ -1,5 +1,149 @@
 # Oysterun
 
+## What Oysterun Is
+
+Oysterun is a deployment and operations platform for working AI agents. It lets
+people run Claude Code or Codex on their own Mac or Linux Host, then operate
+those agents from an iPhone or web browser with persistent sessions,
+scheduling, notifications, reports, websites, local files, and agent skills.
+
+The core idea is that prompts and skills are not enough. A useful agent also
+needs a runtime, tools, permissions, scheduled execution, a readable delivery
+surface, and a reliable way for its user to intervene. Oysterun brings those
+pieces together so an agent can move from "only its author can run it" toward a
+complete AgentFolder that another user can install and operate.
+
+## Build Week Scope
+
+### Introduction
+
+Oysterun is an existing platform that was created before OpenAI Build Week. The
+submission does not claim that the complete Oysterun Host, client, session,
+scheduling, Mail, Website, notification, or skill system was built during the
+event.
+
+For this submission, Build Week work is measured from July 14, 2026 at 00:00
+Asia/Taipei, equivalent to July 13, 2026 at 09:00 Pacific Time. The final
+repository commit before that cutoff is `cf9c8e11` (July 13 at 20:31
+Asia/Taipei), and the submission snapshot is `711c0246` (July 20 at 23:39
+Asia/Taipei). The range `cf9c8e11..711c0246` contains 39 commits including
+merges and changes 159 distinct files.
+
+The work in that measured range focuses on making complete agents easier to
+distribute and use:
+
+- **Stock Research Agent:** a cloneable AgentFolder that researches stocks,
+  generates readable HTML reports, publishes them through Oysterun Website, and
+  can deliver them through Oysterun Mail.
+- **GitHub Tracker Agent:** a cloneable AgentFolder that monitors public GitHub
+  repositories, runs on a schedule, and publishes update reports.
+- **Direct GitHub Agent Store:** a new Oysterun flow that accepts a public
+  GitHub repository URL, safely clones the AgentFolder into the Host, resolves
+  its configuration, starts a session, and opens the resulting chat.
+
+This Build Week submission demonstrates these new agents and the Agent Store
+workflow running on the existing Oysterun platform.
+
+The dated Git history and the submitted Codex `/feedback` Session ID provide
+evidence of the work completed during the submission period.
+
+### Evidence
+
+1. Important Commits:
+    - SQLite migration and tool-detail integration, July 14: `56690244` through `7a2e304e`
+    - Provider aggregation and Telegram delivery follow-ups, July 14:
+    `523c68d9` through `f6c66f58`
+    - Timeline and pagination recovery, July 16:
+    `212a9fd3` through `2caf0fa2`
+    - Browser Root AgentFolder registration, July 19: `87e6df47`
+    - Direct GitHub Agent Store clone/start demo, July 20: `ba6bbdfa`
+2. Team Session:
+    1. PM: 019f5761-**1078**-7dc3-a130-64ac66435cc8
+    2. Team Lead: 019f5760-ee50-70e3-870e-1d16838305f2
+    3. Assistant1: 019f56e8-4c9f-71b2-8ad5-a0232b95686d
+    4. Assistant2: 019f552a-3830-7cf3-92ca-dd483fa63cf9
+    5. Engineer: 019f56fc-c4cd-7120-a2ff-d2c603ebafa7
+    6. Manual Session: 019f05d5-f491-7db3-8bf6-94eba3c89607
+3. Other Repo (Agents):
+    1. https://github.com/GoatWang/oysterun-ccstock-workenv-en
+    2. https://github.com/GoatWang/oysterun-github-tracker
+
+## How Codex And GPT-5.6 Were Used
+
+The work measured from the July 14, 00:00 Asia/Taipei cutoff was developed with
+Codex as the primary engineering environment and GPT-5.6 as the reasoning model
+for planning, codebase investigation, implementation, verification design,
+debugging, and review.
+
+Rather than using Codex only for isolated code generation, Oysterun was
+developed by a persistent AI engineering team running through Oysterun itself:
+
+- two Assistants prepared requirements, verification plans, and progress
+  summaries;
+- one Project Manager coordinated tasks and checked progress every two minutes;
+- one Team Lead reviewed architecture, verification evidence, and priorities;
+- three Engineers implemented and tested scoped changes;
+- every 30 minutes, an Assistant summarized team progress for human review.
+
+The human Owner made the product, security, UX, and release decisions. Codex
+traced behavior across the Host, web client, Matrix facade, provider adapters,
+skills, and operational scripts; implemented the approved phases; and produced
+focused verification evidence. This workflow let the project continue making
+measurable progress while the Owner worked full-time and while the Oysterun Host
+ran remotely on a Mac mini in Taiwan.
+
+## Judge Quickstart
+
+### Hosted review environment (recommended)
+
+A dedicated Oysterun Host URL and its login password are provided privately in
+the project registration form. Judges should follow the access instructions in
+that form; it is the authoritative source for the current Host address and
+credentials. No local installation or rebuild is required for this path.
+
+Available clients:
+
+1. **iOS app**
+   - Install [Oysterun from the App Store](https://apps.apple.com/tw/app/oysterun/id6762069229).
+   - Add the Host URL supplied in the registration form.
+   - Sign in with the supplied Host password.
+2. **Web browser**
+   - Open the Host `/app/` URL supplied in the registration form.
+   - Sign in with the supplied Host password.
+
+Both clients connect to the same dedicated Host and expose the same sessions.
+The password is intentionally not stored in this public repository.
+
+## What Judges Should Test
+
+1. Open the `oysterun-ccstock-workenv-en-da14e` session.
+2. Ask any question, then ask the agent to generate a report.
+3. Open the website URL returned by the agent.
+4. Check the mail box
+5. Ask the agent to create a schedule or send you a Mail item.
+6. Open the Webiste in the external browser
+
+## Oysterun Skills
+
+The repository includes first-party skills that let Codex operate
+Oysterun through its supported CLI rather than direct Host API calls:
+
+- `skills/oysterun-sessions`
+- `skills/oysterun-session-chat`
+- `skills/oysterun-find-context`
+- `skills/oysterun-scheduler`
+- `skills/oysterun-notifications`
+- `skills/oysterun-mail`
+- `skills/oysterun-telegram`
+- `skills/oysterun-website`
+
+`skills/Oysterun` is the umbrella skill set used when Oysterun installs or
+updates the product skills in an AgentFolder.
+
+------------------------------------OpenAI Build Week------------------------------------
+
+## Runtime Pieces
+
 Oysterun currently has three main runtime pieces:
 
 - `backend/`: the Cloud API written in FastAPI

package/dev/client/web/index.html

@@ -12183,6 +12183,7 @@ Waiting for Claude login output…</pre
           lastTestRunScheduleId: "",
           lastTestRunRunId: "",
           lastTestRunOutcome: "",
+          lastTimezoneReconciliationGeneration: 0,
           error: "",
           status: "",
         };
@@ -13191,6 +13192,8 @@ Waiting for Claude login output…</pre
       let projectRegistrationIssues = [];
       let liveSessions = [];
       let sessionHistory = [];
+      const sessionListPreviewBySessionId = new Map();
+      let sessionListPreviewHydrationRequestId = 0;
       let matrixTranscriptSessionIdsByAgent = {};
       let matrixTranscriptMembershipLoadedAtByAgent = {};
       const matrixTranscriptMembershipRequestsByAgent = new Map();
@@ -25009,6 +25012,7 @@ Waiting for Claude login output…</pre
           catalog: createDashboardDataRequestSlot(),
           sessions: createDashboardDataRequestSlot(),
           history: createDashboardDataRequestSlot(),
+          previews: createDashboardDataRequestSlot(),
           providers: createDashboardDataRequestSlot(),
         };
       }
@@ -25039,13 +25043,28 @@ Waiting for Claude login output…</pre
       }
 
       function invalidateDashboardDataCaches(opts = {}) {
-        const keys = ["catalog", "sessions", "history", "providers"];
+        const keys = [
+          "catalog",
+          "sessions",
+          "history",
+          "previews",
+          "providers",
+        ];
         const resetAll = opts.all === true;
         for (const key of keys) {
-          if (resetAll || opts[key] === true) {
+          if (
+            resetAll ||
+            opts[key] === true ||
+            (key === "previews" &&
+              (opts.sessions === true || opts.history === true))
+          ) {
             resetDashboardDataRequestSlot(dashboardDataRequestState[key]);
           }
         }
+        if (resetAll) {
+          sessionListPreviewBySessionId.clear();
+          sessionListPreviewHydrationRequestId += 1;
+        }
         if (
           resetAll ||
           opts.transcripts === true ||
@@ -25138,13 +25157,27 @@ Waiting for Claude login output…</pre
       }
 
       function readDashboardLiveSessions(opts = {}) {
-        return readDashboardDataRequest("sessions", "/sessions", {
-          force: opts.force === true,
-        });
+        return readDashboardDataRequest(
+          "sessions",
+          "/sessions?include_previews=0",
+          {
+            force: opts.force === true,
+          }
+        );
       }
 
       function readDashboardSessionHistory(opts = {}) {
-        return readDashboardDataRequest("history", "/sessions/history", {
+        return readDashboardDataRequest(
+          "history",
+          "/sessions/history?include_previews=0",
+          {
+            force: opts.force === true,
+          }
+        );
+      }
+
+      function readDashboardSessionPreviews(opts = {}) {
+        return readDashboardDataRequest("previews", "/sessions/previews", {
           force: opts.force === true,
         });
       }
@@ -31242,6 +31275,7 @@ Waiting for Claude login output…</pre
             ),
           }));
           sessionHistory = historyData.sessions || [];
+          pruneSessionListPreviewCache();
           explorerState.roots = catalogData.roots || {};
           pruneMatrixTranscriptMembershipCache();
           const selectedLiveSession = getSelectedLiveSession();
@@ -31257,6 +31291,7 @@ Waiting for Claude login output…</pre
             if (keepConnectedSelectedSession) {
               renderExplorerRoots();
               renderCatalog();
+              void hydrateSessionListPreviews();
               renderWebCatalog();
               void refreshMailUnreadCount({ quiet: true });
               updateComposerAvailability();
@@ -31270,6 +31305,7 @@ Waiting for Claude login output…</pre
           }
           renderExplorerRoots();
           renderCatalog();
+          void hydrateSessionListPreviews();
           renderWebCatalog();
           void refreshMailUnreadCount({ quiet: true });
           const activeSelectedSession = selectedSessionId
@@ -31516,6 +31552,142 @@ Waiting for Claude login output…</pre
         return `${providerLabel} · ${modelLabel} · ${folderName}`;
       }
 
+      function getSessionListPreviewState(sessionId) {
+        const normalizedSessionId = sanitizeRouteText(sessionId);
+        return normalizedSessionId
+          ? sessionListPreviewBySessionId.get(normalizedSessionId) || null
+          : null;
+      }
+
+      function getSessionListPreviewText({
+        sessionId,
+        lastMessagePreview,
+        runtime,
+        model,
+        folder,
+      }) {
+        const state = getSessionListPreviewState(sessionId);
+        const resolvedPreview =
+          state?.loaded === true
+            ? state.lastMessagePreview
+            : lastMessagePreview;
+        if (state?.loaded !== true && !resolvedPreview) {
+          return "Loading latest message...";
+        }
+        return getSessionPreviewText({
+          lastMessagePreview: resolvedPreview,
+          runtime,
+          model,
+          folder,
+        });
+      }
+
+      function updateSessionListPreviewDom() {
+        for (const row of document.querySelectorAll(
+          "[data-live-session-id], [data-history-session-id]"
+        )) {
+          const liveSessionId = sanitizeRouteText(
+            row.getAttribute("data-live-session-id")
+          );
+          const historySessionId = sanitizeRouteText(
+            row.getAttribute("data-history-session-id")
+          );
+          const sessionId = liveSessionId || historySessionId;
+          if (!sessionId) continue;
+          const liveSession = liveSessionId
+            ? liveSessions.find((entry) => entry.sessionId === sessionId)
+            : null;
+          const historyRecord = historySessionId
+            ? sessionHistory.find((entry) => entry.session_id === sessionId)
+            : null;
+          const source = liveSession || historyRecord;
+          if (!source) continue;
+          const state = getSessionListPreviewState(sessionId);
+          row.dataset.sessionPreviewStatus = state?.status || "loading";
+          const preview = row.querySelector(".session-row-preview");
+          if (!preview) continue;
+          preview.textContent = getSessionListPreviewText({
+            sessionId,
+            lastMessagePreview:
+              liveSession?.lastMessagePreview ||
+              historyRecord?.last_message_preview ||
+              "",
+            runtime: source.provider || source.runtime || "claude",
+            model: source.model || "default model",
+            folder: source.cwd || source.agent_folder || "",
+          });
+        }
+      }
+
+      function pruneSessionListPreviewCache() {
+        const activeSessionIds = new Set([
+          ...liveSessions.map((entry) => entry.sessionId),
+          ...sessionHistory.map((entry) => entry.session_id),
+        ]);
+        for (const sessionId of sessionListPreviewBySessionId.keys()) {
+          if (!activeSessionIds.has(sessionId)) {
+            sessionListPreviewBySessionId.delete(sessionId);
+          }
+        }
+      }
+
+      async function hydrateSessionListPreviews(opts = {}) {
+        if (!liveSessions.length && !sessionHistory.length) return;
+        const requestId = ++sessionListPreviewHydrationRequestId;
+        try {
+          const data = await readDashboardSessionPreviews({
+            force: opts.force === true,
+          });
+          if (requestId !== sessionListPreviewHydrationRequestId) return;
+          for (const entry of Array.isArray(data.previews)
+            ? data.previews
+            : []) {
+            const sessionId = sanitizeRouteText(entry.session_id);
+            if (!sessionId) continue;
+            sessionListPreviewBySessionId.set(sessionId, {
+              loaded: true,
+              status: sanitizeRouteText(entry.status) || "unavailable",
+              lastMessagePreview:
+                typeof entry.last_message_preview === "string"
+                  ? entry.last_message_preview
+                  : "",
+              latestCommittedSeq: Number(entry.latest_committed_seq) || 0,
+              cacheStatus: sanitizeRouteText(entry.cache_status),
+              errorCode: sanitizeRouteText(entry.error_code),
+            });
+          }
+          updateSessionListPreviewDom();
+        } catch (err) {
+          if (requestId !== sessionListPreviewHydrationRequestId) return;
+          for (const session of liveSessions) {
+            if (!sessionListPreviewBySessionId.has(session.sessionId)) {
+              sessionListPreviewBySessionId.set(session.sessionId, {
+                loaded: true,
+                status: "unavailable",
+                lastMessagePreview: "",
+                latestCommittedSeq: 0,
+                cacheStatus: "request_failed",
+                errorCode: "session_preview_request_failed",
+              });
+            }
+          }
+          for (const record of sessionHistory) {
+            if (!sessionListPreviewBySessionId.has(record.session_id)) {
+              sessionListPreviewBySessionId.set(record.session_id, {
+                loaded: true,
+                status: "unavailable",
+                lastMessagePreview: "",
+                latestCommittedSeq: 0,
+                cacheStatus: "request_failed",
+                errorCode: "session_preview_request_failed",
+              });
+            }
+          }
+          updateSessionListPreviewDom();
+          console.warn("[oysterun-ui] Session preview hydration failed", err);
+        }
+      }
+
       function renderSessionAvatar(runtime, isActive = false) {
         const key = getSessionRuntimeVisualKey(runtime);
         return `
@@ -31883,7 +32055,9 @@ Waiting for Claude login output…</pre
         const lastTouched = formatSessionRelativeTime(
           session.lastActiveAt || session.startedAt
         );
-        const previewText = getSessionPreviewText({
+        const previewState = getSessionListPreviewState(session.sessionId);
+        const previewText = getSessionListPreviewText({
+          sessionId: session.sessionId,
           lastMessagePreview: session.lastMessagePreview,
           runtime,
           model,
@@ -31895,6 +32069,9 @@ Waiting for Claude login output…</pre
             class="agent-entry-card session-list-row session-list-row-live"
             data-live-session-id="${esc(session.sessionId)}"
             data-agent-id="${esc(agentId)}"
+            data-session-preview-status="${esc(
+              previewState?.status || "loading"
+            )}"
           >
             <button
               class="session-row-main"
@@ -31926,7 +32103,9 @@ Waiting for Claude login output…</pre
         const lastTouched = formatSessionRelativeTime(
           record.last_active_at || record.created_at
         );
-        const previewText = getSessionPreviewText({
+        const previewState = getSessionListPreviewState(record.session_id);
+        const previewText = getSessionListPreviewText({
+          sessionId: record.session_id,
           lastMessagePreview: record.last_message_preview,
           runtime,
           model,
@@ -31937,6 +32116,9 @@ Waiting for Claude login output…</pre
             class="agent-entry-card session-list-row session-list-row-history"
             data-history-session-id="${esc(record.session_id)}"
             data-agent-id="${esc(record.agent_id)}"
+            data-session-preview-status="${esc(
+              previewState?.status || "loading"
+            )}"
           >
             <button
               class="session-row-main"
@@ -41468,6 +41650,23 @@ Waiting for Claude login output…</pre
               : "/scheduler/schedules";
           const data = await api("GET", schedulerPath);
           const rows = Array.isArray(data.schedules) ? data.schedules : [];
+          const timezoneReconciliation =
+            data.timezone_reconciliation &&
+            typeof data.timezone_reconciliation === "object"
+              ? data.timezone_reconciliation
+              : null;
+          const timezoneReconciliationGeneration = Number(
+            timezoneReconciliation?.project_index_generation || 0
+          );
+          const timezoneCorrectionCount = Number(
+            timezoneReconciliation?.timezone_correction_count || 0
+          );
+          const showTimezoneCorrection =
+            timezoneCorrectionCount > 0 &&
+            Number.isInteger(timezoneReconciliationGeneration) &&
+            timezoneReconciliationGeneration > 0 &&
+            timezoneReconciliationGeneration !==
+              hostSchedulerState.lastTimezoneReconciliationGeneration;
           const requestedId = sanitizeRouteText(opts.scheduleId);
           const shouldOpenSetup =
             opts.newDraft === true ||
@@ -41487,6 +41686,10 @@ Waiting for Claude login output…</pre
               : [],
             loaded: true,
             loading: false,
+            lastTimezoneReconciliationGeneration:
+              timezoneReconciliationGeneration > 0
+                ? timezoneReconciliationGeneration
+                : hostSchedulerState.lastTimezoneReconciliationGeneration,
             selectedId,
             editingId: shouldOpenSetup
               ? opts.newDraft === true
@@ -41501,6 +41704,11 @@ Waiting for Claude login output…</pre
                 : hostSchedulerState.setupPageMode || "edit"
               : "list",
             error: "",
+            status: showTimezoneCorrection
+              ? `Normalized ${timezoneCorrectionCount} portable schedule timezone${
+                  timezoneCorrectionCount === 1 ? "" : "s"
+                } to this Host.`
+              : "",
           };
         } catch (err) {
           hostSchedulerState = {
@@ -41528,6 +41736,12 @@ Waiting for Claude login output…</pre
             {}
           );
           const rows = Array.isArray(data.schedules) ? data.schedules : [];
+          const timezoneCorrectionCount = Number(
+            data.timezone_correction_count || 0
+          );
+          const timezoneReconciliationGeneration = Number(
+            data.timezone_normalization?.project_index_generation || 0
+          );
           hostSchedulerState = {
             ...hostSchedulerState,
             rows,
@@ -41539,12 +41753,25 @@ Waiting for Claude login output…</pre
             loaded: true,
             refreshing: false,
             loading: false,
+            lastTimezoneReconciliationGeneration:
+              timezoneReconciliationGeneration > 0
+                ? timezoneReconciliationGeneration
+                : hostSchedulerState.lastTimezoneReconciliationGeneration,
             error: "",
-            status: `Refreshed ${Number(
-              data.project_count || 0
-            )} Browser Root project${
-              Number(data.project_count || 0) === 1 ? "" : "s"
-            }.`,
+            status:
+              timezoneCorrectionCount > 0
+                ? `Refreshed ${Number(
+                    data.project_count || 0
+                  )} Browser Root project${
+                    Number(data.project_count || 0) === 1 ? "" : "s"
+                  }. Normalized ${timezoneCorrectionCount} portable schedule timezone${
+                    timezoneCorrectionCount === 1 ? "" : "s"
+                  } to this Host.`
+                : `Refreshed ${Number(
+                    data.project_count || 0
+                  )} Browser Root project${
+                    Number(data.project_count || 0) === 1 ? "" : "s"
+                  }.`,
           };
         } catch (err) {
           hostSchedulerState = {

package/dev/client/web-chat/dist/assets/{ReactPrism-BGRmaJf7.js → ReactPrism-Bny_C7xD.js}

@@ -1,4 +1,4 @@
-import{g as ee,c as Y,r as K,j as Z}from"./index-Cuy-f6-d.js";var X={exports:{}};(function(e){var t=typeof window<"u"?window:typeof WorkerGlobalScope<"u"&&self instanceof WorkerGlobalScope?self:{};/**
+import{g as ee,c as Y,r as K,j as Z}from"./index-CqfVnL4A.js";var X={exports:{}};(function(e){var t=typeof window<"u"?window:typeof WorkerGlobalScope<"u"&&self instanceof WorkerGlobalScope?self:{};/**
 * Prism: Lightweight, robust, elegant syntax highlighting
 *
 * @license MIT <https://opensource.org/licenses/MIT>