@agimon-ai/doompi-author 0.0.1-alpha.2 → 0.0.1-alpha.21

package/src/web/api/authorRuntime.ts

@@ -1,164 +0,0 @@
-import type {
-  ModelContext,
-  ModelContextAbortSignal,
-  ModelContextToolDescriptor,
-  WebPluginRuntime,
-} from '@agimon-ai/doompi-web-contracts';
-import type { AuthorTrustedProfile, AuthorTrustedTool } from '../lib/authorViewportTypes.ts';
-
-export const AUTHOR_RUNTIME_BINDING_IDS = {
-  text: 'author.viewport.text',
-  media: 'author.viewport.media',
-} as const;
-
-interface ActiveCatalog {
-  generation: number;
-  controller: AbortController;
-  profiles: ReadonlyMap<string, AuthorTrustedProfile>;
-}
-
-function assertProfile(profile: AuthorTrustedProfile): void {
-  if (profile.id.trim() === '') throw new Error('Author profile id must not be empty');
-  if (profile.tools.length > 15) throw new Error('Author profiles may expose at most 15 tools');
-  const names = new Set<string>();
-  for (const tool of profile.tools) {
-    if (!/^[a-z][a-z0-9_]{0,29}$/.test(tool.name)) throw new Error(`Invalid Author tool name: ${tool.name}`);
-    if (names.has(tool.name)) throw new Error(`Duplicate Author tool name: ${tool.name}`);
-    names.add(tool.name);
-  }
-}
-
-function descriptorMatches(actual: ModelContextToolDescriptor, expected: AuthorTrustedTool): boolean {
-  return (
-    actual.name === expected.name &&
-    actual.description === expected.description &&
-    JSON.stringify(actual.inputSchema) === JSON.stringify(expected.inputSchema)
-  );
-}
-
-function staleError(): Error {
-  return new Error('Author viewport catalog is stale');
-}
-
-function invocationSignal(
-  catalogSignal: AbortSignal,
-  requestSignal: ModelContextAbortSignal,
-): { signal: AbortSignal; release: () => void } {
-  const controller = new AbortController();
-  const abortCatalog = (): void => controller.abort(catalogSignal.reason);
-  const abortRequest = (): void => controller.abort(requestSignal.reason);
-  if (catalogSignal.aborted) abortCatalog();
-  else if (requestSignal.aborted) abortRequest();
-  else {
-    catalogSignal.addEventListener('abort', abortCatalog, { once: true });
-    requestSignal.addEventListener('abort', abortRequest, { once: true });
-  }
-  return {
-    signal: controller.signal,
-    release: () => {
-      catalogSignal.removeEventListener('abort', abortCatalog);
-      requestSignal.removeEventListener('abort', abortRequest);
-    },
-  };
-}
-
-/** Owns page-lifetime WebMCP registrations. Profiles are replaced as one abortable catalog. */
-export class AuthorRuntime {
-  readonly #runtime: WebPluginRuntime;
-  #context: ModelContext | undefined;
-  #active: ActiveCatalog | undefined;
-  #pending: ActiveCatalog | undefined;
-  #generation = 0;
-  #disposed = false;
-
-  constructor(runtime: WebPluginRuntime) {
-    this.#runtime = runtime;
-  }
-
-  async replaceProfiles(profiles: readonly AuthorTrustedProfile[]): Promise<() => void> {
-    if (this.#disposed) throw new Error('Author runtime is disposed');
-    for (const profile of profiles) assertProfile(profile);
-    const profileMap = new Map(profiles.map((profile) => [profile.id, profile]));
-    const tools = profiles.flatMap((profile) => profile.tools);
-    if (new Set(tools.map((tool) => tool.name)).size !== tools.length) {
-      throw new Error('Author tool names must be unique across trusted profiles');
-    }
-
-    const context = this.#context ?? (await this.#runtime.acquireModelContext?.())?.modelContext;
-    if (context === undefined) throw new Error('Model Context is unavailable');
-    this.#context = context;
-    const generation = ++this.#generation;
-    const controller = new AbortController();
-    const candidate: ActiveCatalog = { generation, controller, profiles: profileMap };
-    const inactive = staleError();
-    this.#pending?.controller.abort(inactive);
-    this.#active?.controller.abort(inactive);
-    this.#pending = candidate;
-    this.#active = undefined;
-    const assertCurrent = (): void => {
-      if (controller.signal.aborted || this.#disposed || this.#active?.generation !== generation) throw staleError();
-    };
-
-    try {
-      await Promise.all(
-        tools.map(async (tool) =>
-          context.registerTool(
-            {
-              name: tool.name,
-              description: tool.description,
-              inputSchema: tool.inputSchema,
-              execute: async (input, options) => {
-                assertCurrent();
-                const parsed: unknown = JSON.parse(input);
-                assertCurrent();
-                const invocation = invocationSignal(controller.signal, options.signal);
-                try {
-                  const result = await tool.execute(parsed, invocation.signal);
-                  assertCurrent();
-                  return result;
-                } finally {
-                  invocation.release();
-                }
-              },
-            },
-            { signal: controller.signal },
-          ),
-        ),
-      );
-      const registered = await context.getTools();
-      if (!tools.every((tool) => registered.some((descriptor) => descriptorMatches(descriptor, tool)))) {
-        throw new Error('Model Context did not confirm the Author catalog');
-      }
-      if (this.#disposed || generation !== this.#generation || this.#pending !== candidate) throw staleError();
-      this.#pending = undefined;
-      this.#active = candidate;
-    } catch (error) {
-      controller.abort(error);
-      if (this.#pending === candidate) this.#pending = undefined;
-      throw error;
-    }
-
-    return () => {
-      if (this.#active?.generation !== generation) return;
-      controller.abort(staleError());
-      this.#active = undefined;
-      this.#generation += 1;
-    };
-  }
-
-  async execute(name: string, input: unknown, signal: AbortSignal): Promise<unknown> {
-    const context = this.#context;
-    if (context === undefined || this.#active === undefined) throw new Error('Author catalog is not registered');
-    return context.executeTool(name, JSON.stringify(input), { signal });
-  }
-
-  dispose(): void {
-    if (this.#disposed) return;
-    this.#disposed = true;
-    this.#generation += 1;
-    this.#pending?.controller.abort(new Error('Author runtime disposed'));
-    this.#active?.controller.abort(new Error('Author runtime disposed'));
-    this.#pending = undefined;
-    this.#active = undefined;
-  }
-}

package/src/web/components/AuthorDocumentPanel.tsx

@@ -1,232 +0,0 @@
-import { Button } from '@agimon-ai/doompi-web-components';
-import { AuthorGridOverlay, autonomousVoiceGridVisible } from './AuthorGridOverlay.tsx';
-import { AuthorMediaView } from './AuthorMediaView.tsx';
-import { AuthorTextView } from './AuthorTextView.tsx';
-import type { FileLinkSource, TransientTab, WebPluginSlotProps } from '@agimon-ai/doompi-web-contracts';
-import { useStore } from '@tanstack/react-store';
-import { useEffect, useRef, useState } from 'react';
-import { focusAuthorViewport } from '../api/authorBrowserBridge.ts';
-import { loadAuthorDocument, saveAuthorDocument } from '../api/authorFiles.ts';
-import { authorProfilesForDocument } from '../stores/authorProfiles.ts';
-import type { AuthorDisplayedRegion } from '../lib/authorViewportTypes.ts';
-import {
-  authorDocumentKey,
-  authorWorkspace,
-  completeAuthorSave,
-  failAuthorSave,
-  focusAuthorDocument,
-  normalizeAuthorPath,
-  putAuthorDocument,
-  releaseAuthorDocumentFocus,
-  requestAuthorSave,
-  syncAuthorDocumentFocus,
-  type AuthorSessionWorkspace,
-} from '../stores/authorWorkspaceStore.ts';
-import { AuthorStructuredView } from './AuthorStructuredView.tsx';
-interface AuthorDocumentPanelProps extends WebPluginSlotProps {
-  path: string;
-}
-
-function tabId(path: string): string {
-  let hash = 2166136261;
-  for (const char of normalizeAuthorPath(path)) hash = Math.imul(hash ^ char.charCodeAt(0), 16777619);
-  return `author-file-${(hash >>> 0).toString(36)}`;
-}
-
-export function displayedAuthorRegions(
-  workspace: AuthorSessionWorkspace | undefined,
-): readonly AuthorDisplayedRegion[] {
-  const draftRegions = workspace?.regions ?? [];
-  if (draftRegions.length > 0) return draftRegions.map((region, index) => ({ ordinal: index + 1, region }));
-  const activeRequest = workspace?.requests.findLast(
-    (request) => request.status === 'REQUESTED' || request.status === 'CHANGING',
-  );
-  return (activeRequest?.pendingRegions ?? []).map((region) => ({
-    ordinal: Math.max(1, (activeRequest?.regions.findIndex((original) => original.id === region.id) ?? 0) + 1),
-    region,
-  }));
-}
-export function AuthorDocumentPanel(props: AuthorDocumentPanelProps) {
-  if (!props.activeMinorModes?.includes('author')) {
-    const fallback = props.fileTabFor(props.path);
-    if (fallback !== undefined && fallback.id !== tabId(props.path)) {
-      return <fallback.panel {...props} />;
-    }
-    return (
-      <p data-testid="author-mode-inactive" className="p-3 text-xs text-doom-dim">
-        No file viewer is available for this path.
-      </p>
-    );
-  }
-  return <ActiveAuthorDocumentPanel {...props} />;
-}
-
-function ActiveAuthorDocumentPanel({ path, sessionId, statuses }: AuthorDocumentPanelProps) {
-  const document = useStore(authorWorkspace.store, (state) =>
-    sessionId === null ? undefined : state.documents[authorDocumentKey(sessionId, path)],
-  );
-  const focusGeneration = useRef<number | undefined>(undefined);
-  const workspace = useStore(authorWorkspace.store, (state) =>
-    sessionId === null ? undefined : state.sessions[sessionId],
-  );
-  const activeTool = workspace?.activeTool ?? 'select';
-  const [markdownPreview, setMarkdownPreview] = useState(true);
-  const [status, setStatus] = useState<string | undefined>();
-  const kind = document?.kind;
-  useEffect(() => {
-    if (document !== undefined || sessionId === null) return;
-    const controller = new AbortController();
-    setStatus('loading');
-    void loadAuthorDocument(sessionId, path, controller.signal)
-      .then((loaded) => {
-        if (controller.signal.aborted) return;
-        putAuthorDocument(sessionId, loaded);
-        setStatus(undefined);
-      })
-      .catch((error: unknown) => {
-        if (!controller.signal.aborted) setStatus(error instanceof Error ? error.message : String(error));
-      });
-    return () => controller.abort();
-  }, [document, path, sessionId]);
-  useEffect(() => {
-    if (document === undefined || sessionId === null) return;
-    const generation = focusAuthorDocument(sessionId, path, document.version, document.sourceSha256);
-    focusGeneration.current = generation;
-    return () => releaseAuthorDocumentFocus(sessionId, generation);
-  }, [kind, document?.sourceSha256, path, sessionId]);
-  useEffect(() => {
-    const generation = focusGeneration.current;
-    if (document === undefined || sessionId === null || generation === undefined) return;
-    syncAuthorDocumentFocus(sessionId, generation, document.version, document.sourceSha256);
-  }, [document?.sourceSha256, document?.version, sessionId]);
-  useEffect(() => {
-    if (kind === undefined || sessionId === null) return;
-    const profiles = authorProfilesForDocument(sessionId, path, kind);
-    let release: (() => void) | undefined;
-    let cancelled = false;
-    void focusAuthorViewport(sessionId, profiles).then((nextRelease) => {
-      if (cancelled) nextRelease();
-      else release = nextRelease;
-    });
-    return () => {
-      cancelled = true;
-      release?.();
-    };
-  }, [kind, path, sessionId]);
-  if (document === undefined || sessionId === null) {
-    return <p className="p-4 text-[11px] text-doom-faint">{status ?? 'Loading document...'}</p>;
-  }
-
-  const save = async (): Promise<void> => {
-    const savedVersion = document.version;
-    const savedFragments = document.fragments;
-    requestAuthorSave(sessionId, path);
-    setStatus('saving');
-    try {
-      const sha256 = await saveAuthorDocument(sessionId, document);
-      completeAuthorSave(sessionId, path, sha256, savedVersion, savedFragments);
-      setStatus('saved');
-    } catch (error) {
-      failAuthorSave(sessionId, path, savedVersion);
-      setStatus(error instanceof Error ? error.message : String(error));
-    }
-  };
-  const gridVisible = autonomousVoiceGridVisible(statuses);
-  const displayedRegions = displayedAuthorRegions(workspace);
-  const textPanel = (
-    <AuthorTextView
-      sessionId={sessionId}
-      document={document}
-      preview={document.kind === 'markdown' && markdownPreview && activeTool === 'select' && !gridVisible}
-      displayedRegions={displayedRegions}
-    />
-  );
-
-  return (
-    <section data-testid="author-document" className="flex min-h-0 flex-1 flex-col">
-      <header className="flex items-center gap-2 border-b border-doom-border px-4 py-2">
-        <strong className="min-w-0 flex-1 truncate text-sm text-doom-hi">{document.title ?? document.path}</strong>
-        {document.kind === 'markdown' ? (
-          <Button
-            size="xs"
-            variant="ghost"
-            data-testid="author-markdown-toggle"
-            onClick={() => setMarkdownPreview(!markdownPreview)}
-          >
-            {markdownPreview ? 'edit' : 'preview'}
-          </Button>
-        ) : null}
-        {document.kind === 'video' ? (
-          <span className="text-sm text-doom-dim">Video feedback</span>
-        ) : (
-          <Button
-            className="min-h-11 px-4 text-sm"
-            variant="outline"
-            data-testid="author-save"
-            disabled={document.revisions.length === 0 || document.savingVersion !== undefined}
-            onClick={() => void save()}
-          >
-            Save
-          </Button>
-        )}
-      </header>
-      {status === undefined ? null : <output className="px-4 py-1 text-[10px] text-doom-faint">{status}</output>}
-      <div className="relative flex min-h-0 flex-1 overflow-hidden">
-        {document.kind === 'text' || document.kind === 'markdown' ? (
-          textPanel
-        ) : document.structuredFormat !== undefined ? (
-          <AuthorStructuredView sessionId={sessionId} document={document} displayedRegions={displayedRegions} />
-        ) : (
-          <AuthorMediaView
-            key={document.path}
-            sessionId={sessionId}
-            document={document}
-            activeTool={activeTool}
-            displayedRegions={displayedRegions}
-            pendingCandidate={workspace?.candidate !== undefined}
-            seekRequest={workspace?.videoSeekRequest}
-          />
-        )}
-        <AuthorGridOverlay sessionId={sessionId} document={document} visible={gridVisible} />
-      </div>
-    </section>
-  );
-}
-
-export function authorFileTab(path: string): TransientTab {
-  const normalized = normalizeAuthorPath(path);
-  return {
-    id: tabId(normalized),
-    label: normalized.split('/').at(-1) ?? normalized,
-    retainComposer: true,
-    panel: (props) => <AuthorDocumentPanel {...props} path={normalized} />,
-  };
-}
-
-export const authorFileLinks: FileLinkSource = {
-  requiredMinorMode: 'author',
-  subscribe(listener) {
-    const subscription = authorWorkspace.store.subscribe(listener);
-    return () => subscription.unsubscribe();
-  },
-  fingerprint(sessionId) {
-    if (sessionId === null) return '';
-    const prefix = `${sessionId}\n`;
-    return Object.keys(authorWorkspace.store.state.documents)
-      .filter((key) => key.startsWith(prefix))
-      .sort()
-      .join('\n');
-  },
-  resolve(sessionId, path) {
-    if (sessionId === null) return undefined;
-    const normalized = normalizeAuthorPath(path.replace(/:\d+(?::\d+)?$/, ''));
-    return authorWorkspace.store.state.documents[authorDocumentKey(sessionId, normalized)] === undefined
-      ? undefined
-      : authorFileTab(normalized);
-  },
-  openPath(sessionId, path) {
-    if (sessionId === null) return undefined;
-    const normalized = normalizeAuthorPath(path);
-    return normalized === '' ? undefined : authorFileTab(normalized);
-  },
-};

package/src/web/components/AuthorGridOverlay.tsx

@@ -1,81 +0,0 @@
-import { useEffect, useRef } from 'react';
-import {
-  AUTHOR_GRID_COLUMNS,
-  AUTHOR_GRID_SIZE,
-  clearAuthorGridGeometry,
-  updateAuthorGridGeometry,
-} from '../lib/authorGrid.ts';
-import type { AuthorWorkspaceDocument } from '../stores/authorWorkspaceStore.ts';
-
-export function autonomousVoiceGridVisible(statuses: Readonly<Record<string, string>>): boolean {
-  return statuses['doom-voice']?.trimStart().startsWith('voice auto:') === true;
-}
-
-export function AuthorGridOverlay({
-  sessionId,
-  document,
-  visible,
-}: {
-  sessionId: string;
-  document: AuthorWorkspaceDocument;
-  visible: boolean;
-}) {
-  const host = useRef<HTMLDivElement>(null);
-  useEffect(() => {
-    const element = host.current?.parentElement;
-    if (!visible || element === null || element === undefined) {
-      clearAuthorGridGeometry(sessionId);
-      return;
-    }
-    const publish = () => {
-      const bounds = element.getBoundingClientRect();
-      updateAuthorGridGeometry(sessionId, {
-        documentPath: document.path,
-        revision: document.version,
-        sourceSha256: document.sourceSha256,
-        viewport: {
-          width: bounds.width,
-          height: bounds.height,
-          originX: bounds.left,
-          originY: bounds.top,
-          scrollX: element.scrollLeft,
-          scrollY: element.scrollTop,
-          zoom: window.devicePixelRatio,
-        },
-      });
-    };
-    publish();
-    const observer = new ResizeObserver(publish);
-    observer.observe(element);
-    element.addEventListener('scroll', publish, { passive: true, capture: true });
-    window.addEventListener('focus', publish);
-    return () => {
-      observer.disconnect();
-      element.removeEventListener('scroll', publish, true);
-      window.removeEventListener('focus', publish);
-      clearAuthorGridGeometry(sessionId);
-    };
-  }, [document.path, document.sourceSha256, document.version, sessionId, visible]);
-  if (!visible) return null;
-  return (
-    <div
-      ref={host}
-      data-testid="author-grid"
-      aria-hidden="true"
-      className="pointer-events-none absolute inset-0 z-20 grid grid-cols-8 grid-rows-8"
-    >
-      {Array.from({ length: AUTHOR_GRID_SIZE * AUTHOR_GRID_SIZE }, (_, index) => {
-        const column = index % AUTHOR_GRID_SIZE;
-        const row = Math.floor(index / AUTHOR_GRID_SIZE);
-        return (
-          <div key={index} className="relative border border-doom-red/25">
-            <span className="absolute left-1 top-0.5 rounded bg-doom-deep/80 px-1 text-[8px] font-bold text-doom-red">
-              {AUTHOR_GRID_COLUMNS[column]}
-              {row + 1}
-            </span>
-          </div>
-        );
-      })}
-    </div>
-  );
-}

package/src/web/components/AuthorMediaPreview.tsx

@@ -1,41 +0,0 @@
-import { MediaPreview } from '@agimon-ai/doompi-web-components';
-import { useEffect, useState } from 'react';
-import { authorSessionFileUrl } from '../api/authorFiles.ts';
-import { loadAuthorMedia } from '../api/authorMedia.ts';
-
-/** Viewing an attachment does not require enabling authoring or its editing tools. */
-export function AuthorMediaPreview({ sessionId, path }: { sessionId: string; path: string }) {
-  const source = authorSessionFileUrl(sessionId, path);
-  const [loaded, setLoaded] = useState<{ source: string; url?: string; error?: string }>();
-  useEffect(() => {
-    const controller = new AbortController();
-    let dispose: (() => void) | undefined;
-    void loadAuthorMedia(source, controller.signal)
-      .then((asset) => {
-        if (controller.signal.aborted) {
-          asset.dispose();
-          return;
-        }
-        dispose = () => asset.dispose();
-        setLoaded({ source, url: asset.url });
-      })
-      .catch((error: unknown) => {
-        if (!controller.signal.aborted)
-          setLoaded({ source, error: error instanceof Error ? error.message : String(error) });
-      });
-    return () => {
-      controller.abort();
-      dispose?.();
-    };
-  }, [source]);
-  const current = loaded?.source === source ? loaded : undefined;
-  return (
-    <div className="min-h-0 flex-1 overflow-auto p-4">
-      {current?.url === undefined ? (
-        <p role={current?.error ? 'alert' : 'status'}>{current?.error ?? 'Loading media...'}</p>
-      ) : (
-        <MediaPreview src={current.url} path={path} data-testid="author-media-preview" />
-      )}
-    </div>
-  );
-}