gsd-pi 2.3.6 → 2.3.8

package/src/resources/extensions/remote-questions/store.ts

@@ -0,0 +1,77 @@
+/**
+ * Remote Questions — durable prompt store
+ */
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import type { RemotePrompt, RemotePromptRecord, RemotePromptRef, RemoteAnswer, RemotePromptStatus } from "./types.js";
+
+function runtimeDir(): string {
+  return join(homedir(), ".gsd", "runtime", "remote-questions");
+}
+
+function recordPath(id: string): string {
+  return join(runtimeDir(), `${id}.json`);
+}
+
+export function createPromptRecord(prompt: RemotePrompt): RemotePromptRecord {
+  return {
+    version: 1,
+    id: prompt.id,
+    createdAt: prompt.createdAt,
+    updatedAt: Date.now(),
+    status: "pending",
+    channel: prompt.channel,
+    timeoutAt: prompt.timeoutAt,
+    pollIntervalMs: prompt.pollIntervalMs,
+    questions: prompt.questions,
+    context: prompt.context,
+  };
+}
+
+export function writePromptRecord(record: RemotePromptRecord): void {
+  mkdirSync(runtimeDir(), { recursive: true });
+  writeFileSync(recordPath(record.id), JSON.stringify(record, null, 2) + "\n", "utf-8");
+}
+
+export function readPromptRecord(id: string): RemotePromptRecord | null {
+  const path = recordPath(id);
+  if (!existsSync(path)) return null;
+  try {
+    return JSON.parse(readFileSync(path, "utf-8")) as RemotePromptRecord;
+  } catch {
+    return null;
+  }
+}
+
+export function updatePromptRecord(
+  id: string,
+  updates: Partial<RemotePromptRecord>,
+): RemotePromptRecord | null {
+  const current = readPromptRecord(id);
+  if (!current) return null;
+  const next: RemotePromptRecord = {
+    ...current,
+    ...updates,
+    updatedAt: Date.now(),
+  };
+  writePromptRecord(next);
+  return next;
+}
+
+export function markPromptDispatched(id: string, ref: RemotePromptRef): RemotePromptRecord | null {
+  return updatePromptRecord(id, { ref, status: "pending" });
+}
+
+export function markPromptAnswered(id: string, response: RemoteAnswer): RemotePromptRecord | null {
+  return updatePromptRecord(id, { response, status: "answered", lastPollAt: Date.now() });
+}
+
+export function markPromptStatus(id: string, status: RemotePromptStatus, lastError?: string): RemotePromptRecord | null {
+  return updatePromptRecord(id, {
+    status,
+    lastPollAt: Date.now(),
+    ...(lastError ? { lastError } : {}),
+  });
+}

package/src/resources/extensions/remote-questions/types.ts

@@ -0,0 +1,75 @@
+/**
+ * Remote Questions — shared types
+ */
+
+export type RemoteChannel = "slack" | "discord";
+
+export interface RemoteQuestionOption {
+  label: string;
+  description: string;
+}
+
+export interface RemoteQuestion {
+  id: string;
+  header: string;
+  question: string;
+  options: RemoteQuestionOption[];
+  allowMultiple: boolean;
+}
+
+export interface RemotePrompt {
+  id: string;
+  channel: RemoteChannel;
+  createdAt: number;
+  timeoutAt: number;
+  pollIntervalMs: number;
+  questions: RemoteQuestion[];
+  context?: {
+    source: string;
+  };
+}
+
+export interface RemotePromptRef {
+  id: string;
+  channel: RemoteChannel;
+  messageId: string;
+  channelId: string;
+  threadTs?: string;
+  threadUrl?: string;
+}
+
+export interface RemoteAnswer {
+  answers: Record<string, { answers: string[]; user_note?: string }>;
+}
+
+export type RemotePromptStatus = "pending" | "answered" | "timed_out" | "failed" | "cancelled";
+
+export interface RemotePromptRecord {
+  version: 1;
+  id: string;
+  createdAt: number;
+  updatedAt: number;
+  status: RemotePromptStatus;
+  channel: RemoteChannel;
+  timeoutAt: number;
+  pollIntervalMs: number;
+  questions: RemoteQuestion[];
+  ref?: RemotePromptRef;
+  response?: RemoteAnswer;
+  lastPollAt?: number;
+  lastError?: string;
+  context?: {
+    source: string;
+  };
+}
+
+export interface RemoteDispatchResult {
+  ref: RemotePromptRef;
+}
+
+export interface ChannelAdapter {
+  readonly name: RemoteChannel;
+  validate(): Promise<void>;
+  sendPrompt(prompt: RemotePrompt): Promise<RemoteDispatchResult>;
+  pollAnswer(prompt: RemotePrompt, ref: RemotePromptRef): Promise<RemoteAnswer | null>;
+}