@things-factory/ai-assistant 10.1.112 → 10.1.114

package/client/components/assistant-chat.ts

@@ -70,6 +70,7 @@ import { availableTriggers, type TriggerChip } from './chat-triggers.js'
 import './entry-review.js'
 import { entryGroupOf, entryReadyCount, entryTitle, isChangeProposal, isEntryProposal, latestEntryKeys } from '../utils/entry-proposal.js'
 import { isWorkspaceProposal, versionOfCard, workspaceAddress } from '../utils/workspace.js'
+import { isOpenPageProposal, openPageNote } from '../utils/open-page.js'
 
 interface ChatLine {
   role: 'user' | 'assistant' | 'system'
@@ -4321,6 +4322,8 @@ export class OxAssistantChat extends LitElement {
           const key = this.proposalKey(p)
           /* A workspace card opens the page; it runs nothing (design/ai/workspace.md §4). */
           if (isWorkspaceProposal(p)) return this.renderWorkspaceCard(p, key)
+          /* A screen card opens the application's list with the question's conditions; it runs nothing (design/ai/read-targets.md §5). */
+          if (isOpenPageProposal(p)) return this.renderOpenPageCard(p)
           const card = proposalCardState(key, { outcomes, requested, sentHere: this.sentProposals.has(key) })
           const entry = isEntryProposal(p)
           const replaced = entry && latestEntry?.get(entryGroupOf(p)) !== key && card.state === 'ready'
@@ -4415,6 +4418,22 @@ export class OxAssistantChat extends LitElement {
     `
   }
 
+  /** The screen card - which list, the conditions the screen does not take, and the way to open it. */
+  private renderOpenPageCard(p: any) {
+    const note = openPageNote(p, (key, options) => String(i18next.t(key, options)))
+    const open = () => this.dispatchEvent(new CustomEvent('assistant-open-page', { detail: { href: p.href }, bubbles: true, composed: true }))
+    return html`
+      <div class="proposal workspace">
+        <md-icon>${p.icon || 'open_in_new'}</md-icon>
+        <span class="pbody">
+          <span class="plabel">${p.label}</span>
+          ${note ? html`<span class="preason">${note}</span>` : nothing}
+        </span>
+        <button class="run" @click=${open}>${i18next.t('ai-assistant.screen.open', { defaultValue: 'open the screen' })}</button>
+      </div>
+    `
+  }
+
   /** The AI 작업판 card - what it holds, which version, and the way to open it. The person opens it; the model does not. */
   private renderWorkspaceCard(p: any, key: string) {
     const { version, of } = versionOfCard(this.lines.map(one => one.proposals ?? []), p.workspace.name, key)

package/client/utils/open-page.ts

@@ -0,0 +1,21 @@
+/*
+ * The card that opens an application's list screen with the conditions of a question (design/ai/read-targets.md §5).
+ * It reads nothing and runs nothing - the person presses it and the page opens beside the dock.
+ */
+
+/** An address inside the application - never another origin, never a script. */
+export function isAppAddress(href: unknown): href is string {
+  return typeof href === 'string' && !!href.trim() && !/^[a-z][a-z0-9+.-]*:/i.test(href.trim()) && !href.trim().startsWith('//')
+}
+
+export function isOpenPageProposal(proposal: any): boolean {
+  return proposal?.kind === 'open-page' && isAppAddress(proposal?.href)
+}
+
+/** The line under the card's title - the conditions the screen does not take, said, never dropped quietly. */
+export function openPageNote(proposal: any, t: (key: string, options?: any) => string): string {
+  const missing: string[] = Array.isArray(proposal?.notAppliedLabels) ? proposal.notAppliedLabels : []
+  return missing.length
+    ? t('ai-assistant.screen.not-applied', { defaultValue: 'the screen does not take: {conditions}', conditions: missing.join(', ') })
+    : ''
+}

package/dist-client/components/assistant-chat.d.ts

@@ -560,6 +560,8 @@ export declare class OxAssistantChat extends LitElement {
      * 실행 결과는 호스트가 **대화에 기록**한다 — 누가 무엇을 실행했는지가 협의 이력에 남아야 한다.
      */
     private renderProposals;
+    /** The screen card - which list, the conditions the screen does not take, and the way to open it. */
+    private renderOpenPageCard;
     /** The AI 작업판 card - what it holds, which version, and the way to open it. The person opens it; the model does not. */
     private renderWorkspaceCard;
     /**

package/dist-client/components/assistant-chat.js

@@ -54,6 +54,7 @@ import { availableTriggers } from './chat-triggers.js';
 import './entry-review.js';
 import { entryGroupOf, entryReadyCount, entryTitle, isChangeProposal, isEntryProposal, latestEntryKeys } from '../utils/entry-proposal.js';
 import { isWorkspaceProposal, versionOfCard, workspaceAddress } from '../utils/workspace.js';
+import { isOpenPageProposal, openPageNote } from '../utils/open-page.js';
 function formatFileSize(bytes) {
     if (!bytes || bytes < 1024)
         return `${bytes || 0} B`;
@@ -3868,6 +3869,9 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
             /* A workspace card opens the page; it runs nothing (design/ai/workspace.md §4). */
             if (isWorkspaceProposal(p))
                 return this.renderWorkspaceCard(p, key);
+            /* A screen card opens the application's list with the question's conditions; it runs nothing (design/ai/read-targets.md §5). */
+            if (isOpenPageProposal(p))
+                return this.renderOpenPageCard(p);
             const card = proposalCardState(key, { outcomes, requested, sentHere: this.sentProposals.has(key) });
             const entry = isEntryProposal(p);
             const replaced = entry && latestEntry?.get(entryGroupOf(p)) !== key && card.state === 'ready';
@@ -3959,6 +3963,21 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
       </div>
     `;
     }
+    /** The screen card - which list, the conditions the screen does not take, and the way to open it. */
+    renderOpenPageCard(p) {
+        const note = openPageNote(p, (key, options) => String(i18next.t(key, options)));
+        const open = () => this.dispatchEvent(new CustomEvent('assistant-open-page', { detail: { href: p.href }, bubbles: true, composed: true }));
+        return html `
+      <div class="proposal workspace">
+        <md-icon>${p.icon || 'open_in_new'}</md-icon>
+        <span class="pbody">
+          <span class="plabel">${p.label}</span>
+          ${note ? html `<span class="preason">${note}</span>` : nothing}
+        </span>
+        <button class="run" @click=${open}>${i18next.t('ai-assistant.screen.open', { defaultValue: 'open the screen' })}</button>
+      </div>
+    `;
+    }
     /** The AI 작업판 card - what it holds, which version, and the way to open it. The person opens it; the model does not. */
     renderWorkspaceCard(p, key) {
         const { version, of } = versionOfCard(this.lines.map(one => one.proposals ?? []), p.workspace.name, key);