@giladbarnea/pi-simple-team 1.0.37 → 1.0.39

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.
package/README.md CHANGED
@@ -212,7 +212,8 @@ Kept minimal:
212
212
  | | With team | `teamsend` |
213
213
  | | On team | `teamstatus`, `teamlog` |
214
214
  | | On everyone | `report_context_window` |
215
- | **Overseeing teammate** | On own teams | Same tools as the main agent |
215
+ | | On self | `schedule_reminder` |
216
+ | **Overseeing teammate** | On self and own teams | Same tools as the main agent |
216
217
  | | With parent team | `teamsend`, `teamstatus`, `teammain` |
217
218
  | **Teammates** | With team | `teamsend` |
218
219
  | | With main | `teammain` |
package/index.ts CHANGED
@@ -24,7 +24,7 @@ import {
24
24
  type TeamManifestMember,
25
25
  } from "./team-registry.ts";
26
26
  import { appendTeamLog, filterTeamLog, normalizeChildEvent, pageTeamLog, preview, renderTeamLogPage, type TeamLogEntry } from "./teamlog.ts";
27
- import { renderTeamMessage, renderTeamToolCall, renderTeamToolResult, type TeamMessageDetails } from "./render.ts";
27
+ import { renderReminderToolCall, renderReminderToolResult, renderTeamMessage, renderTeamToolCall, renderTeamToolResult, type TeamMessageDetails } from "./render.ts";
28
28
  import { openTeamOverview, type TeamSnapshot } from "./team-ui.ts";
29
29
  import { StringEnum } from "@earendil-works/pi-ai";
30
30
  import { Type } from "typebox";
@@ -844,6 +844,7 @@ export default function (pi: ExtensionAPI) {
844
844
  const parentPiExecutable = process.argv[1];
845
845
  if (!parentPiExecutable) throw new Error("pi-simple-team could not locate the parent Pi executable");
846
846
  const owner = Symbol("pi-simple-team-owner");
847
+ const reminderTimers = new Set<ReturnType<typeof setTimeout>>();
847
848
  const sessionTeammateRoster = childRuntimeConfig?.participants ?? [];
848
849
  pi.registerMessageRenderer(teamMessageType, (message, _options, theme) => renderTeamMessage(message, theme, getMarkdownTheme(), sessionTeammateRoster));
849
850
 
@@ -855,6 +856,8 @@ export default function (pi: ExtensionAPI) {
855
856
  });
856
857
 
857
858
  pi.on("session_shutdown", async () => {
859
+ for (const timer of reminderTimers) clearTimeout(timer);
860
+ reminderTimers.clear();
858
861
  for (const team of [...teams.values()]) {
859
862
  if (team.owner === owner) await shutdownTeam(team);
860
863
  }
@@ -981,6 +984,36 @@ export default function (pi: ExtensionAPI) {
981
984
  );
982
985
  });
983
986
 
987
+ pi.registerTool(
988
+ defineTool({
989
+ name: "schedule_reminder",
990
+ label: "Schedule Reminder",
991
+ description: "Set yourself a one-shot reminder that wakes you with a custom message after a specified number of minutes.",
992
+ promptSnippet: "Use schedule_reminder as a safety net for team oversight if delegates do not wake you proactively. Ask whether the user wants periodic checks, such as every 30 minutes. Recommend this safety net more strongly as the expected run time grows, especially for multi-hour unattended work. For periodic checks, schedule the next reminder after each check.",
993
+ renderShell: "self",
994
+ renderCall: (args, theme, context) => renderReminderToolCall(args, theme, context),
995
+ renderResult: (result, options, theme, context) => renderReminderToolResult(result, options, theme, context),
996
+ parameters: Type.Object({
997
+ delayMinutes: Type.Number({ exclusiveMinimum: 0, maximum: 35_791, description: "Minutes until the reminder" }),
998
+ message: Type.String({ minLength: 1, description: "Custom message that wakes you" }),
999
+ }),
1000
+ async execute(_toolCallId, params) {
1001
+ const delayMilliseconds = params.delayMinutes * 60_000;
1002
+ const scheduledAt = new Date(Date.now() + delayMilliseconds).toISOString();
1003
+ const timer = setTimeout(() => {
1004
+ reminderTimers.delete(timer);
1005
+ pi.sendMessage(
1006
+ { customType: "pi-simple-team-reminder", content: params.message, display: false },
1007
+ { deliverAs: "followUp", triggerTurn: true },
1008
+ );
1009
+ }, delayMilliseconds);
1010
+ reminderTimers.add(timer);
1011
+ timer.unref();
1012
+ return toolResult({ scheduledAt, message: params.message });
1013
+ },
1014
+ }),
1015
+ );
1016
+
984
1017
  pi.registerTool(
985
1018
  defineTool({
986
1019
  name: "team_list",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@giladbarnea/pi-simple-team",
3
- "version": "1.0.37",
3
+ "version": "1.0.39",
4
4
  "description": "A flat, live team of Pi agents.",
5
5
  "keywords": [
6
6
  "pi-package",
package/render.ts CHANGED
@@ -345,6 +345,19 @@ export function teamShutdownLines(theme: ThemeLike, team: string, teammates: str
345
345
  return [header, `${treeConnector(theme, "└")}${actorList(theme, teammates, roster, glyphs().dot)}`];
346
346
  }
347
347
 
348
+ function reminderCallBody(theme: ThemeLike, args: Record<string, unknown>): string {
349
+ const delayMinutes = args.delayMinutes;
350
+ const message = typeof args.message === "string" ? args.message : "";
351
+ const target = typeof delayMinutes === "number" ? theme.fg("accent", `in ${plural(delayMinutes, "minute")}`) : "";
352
+ return callBody(theme, "Schedule Reminder", target, message ? [theme.fg("muted", formatCharCount(message.length))] : []);
353
+ }
354
+
355
+ export function scheduleReminderLines(theme: ThemeLike, options: { delayMinutes: number; message: string; expanded: boolean }): TeamLine[] {
356
+ const header = `${stackPrefix(theme)}${reminderCallBody(theme, options)}`;
357
+ const lineLimit = options.expanded ? Number.POSITIVE_INFINITY : SEND_PREVIEW_LINES;
358
+ return [header, ...quotedBody(theme, options.message, { lineLimit, barToken: "muted" })];
359
+ }
360
+
348
361
  const TEAMMATE_HUE_TOKENS = ["mdCode", "customMessageLabel", "mdHeading"] as const;
349
362
 
350
363
  /**
@@ -857,6 +870,30 @@ export function renderTeamToolResult(
857
870
  return new TeamLines(resultLinesFor(tool, theme, args, details, options.expanded, roster), options.expanded ? "wrap" : "clip");
858
871
  }
859
872
 
873
+ export function renderReminderToolCall(args: Record<string, unknown>, theme: ThemeLike, context: ToolRenderContextLike) {
874
+ return renderPendingCall(reminderCallBody(theme, args ?? {}), theme, context, context?.cwd);
875
+ }
876
+
877
+ export function renderReminderToolResult(
878
+ result: { isError?: boolean; details?: unknown },
879
+ options: { expanded: boolean },
880
+ theme: ThemeLike,
881
+ context: ToolRenderContextLike,
882
+ ): TeamLines {
883
+ const args = (context?.args ?? {}) as Record<string, unknown>;
884
+ if (context?.isError || result?.isError) {
885
+ return new TeamLines(errorLines(theme, reminderCallBody(theme, args), textContent(result)), options.expanded ? "wrap" : "clip");
886
+ }
887
+ return new TeamLines(
888
+ scheduleReminderLines(theme, {
889
+ delayMinutes: args.delayMinutes as number,
890
+ message: args.message as string,
891
+ expanded: options.expanded,
892
+ }),
893
+ options.expanded ? "wrap" : "clip",
894
+ );
895
+ }
896
+
860
897
  export function renderTeamMessage(message: { details?: unknown }, theme: ThemeLike, markdownTheme?: MarkdownTheme, roster: string[] = []): TeamMessageView | TeamLines | undefined {
861
898
  const details = message.details as TeamMessageDetails | undefined;
862
899
  if (!details?.from || !details?.team || typeof details.message !== "string") return undefined;