@things-factory/operato-board 10.0.0-beta.61 → 10.0.0-beta.64

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/operato-board",
-  "version": "10.0.0-beta.61",
+  "version": "10.0.0-beta.64",
   "main": "dist-server/index.js",
   "browser": "dist-client/index.js",
   "things-factory": true,
@@ -98,8 +98,8 @@
     "@things-factory/auth-google": "^10.0.0-beta.57",
     "@things-factory/auth-ui": "^10.0.0-beta.57",
     "@things-factory/board-service": "^10.0.0-beta.61",
-    "@things-factory/board-ui": "^10.0.0-beta.61",
-    "@things-factory/codelingua": "^10.0.0-beta.57",
+    "@things-factory/board-ui": "^10.0.0-beta.64",
+    "@things-factory/codelingua": "^10.0.0-beta.64",
     "@things-factory/context-ui": "^10.0.0-beta.53",
     "@things-factory/evaluation": "^10.0.0-beta.53",
     "@things-factory/export-ui": "^10.0.0-beta.53",
@@ -110,11 +110,13 @@
     "@things-factory/i18n-base": "^10.0.0-beta.57",
     "@things-factory/import-ui": "^10.0.0-beta.57",
     "@things-factory/integration-base": "^10.0.0-beta.57",
+    "@things-factory/integration-data-go-kr": "^10.0.0-beta.63",
     "@things-factory/integration-email": "^10.0.0-beta.57",
     "@things-factory/integration-influxdb": "^10.0.0-beta.57",
+    "@things-factory/integration-juso": "^10.0.0-beta.63",
     "@things-factory/integration-msgraph": "^10.0.0-beta.57",
     "@things-factory/integration-notification": "^10.0.0-beta.61",
-    "@things-factory/integration-openai": "^10.0.0-beta.57",
+    "@things-factory/integration-openai": "^10.0.0-beta.64",
     "@things-factory/integration-ui": "^10.0.0-beta.57",
     "@things-factory/integration-weather": "^10.0.0-beta.57",
     "@things-factory/more-ui": "^10.0.0-beta.53",
@@ -136,5 +138,5 @@
   "resolutions": {
     "passport": "^0.7.0"
   },
-  "gitHead": "af0f3368e167919fb061cce4f3069849f67bde94"
+  "gitHead": "8a2729cb8c838ed8fc3c7921fa67f7279c2d13b1"
 }

package/schema.graphql

@@ -3,15 +3,6 @@
 # !!!   DO NOT MODIFY THIS FILE BY YOURSELF   !!!
 # -----------------------------------------------
 
-input APIDocCompletionInput {
-  code: String!
-  language: String
-}
-
-type APIDocCompletionOutput {
-  message: String
-}
-
 """Represents a pair of access and refresh tokens."""
 type AccessToken {
   """The access token for API authentication."""
@@ -356,6 +347,7 @@ type Attachment {
   refType: String
   size: String!
   tags: Object
+  thumbnail: String
   updatedAt: DateTimeISO!
   updater: User
 }
@@ -688,6 +680,77 @@ type Board {
   version: Float
 }
 
+input BoardAIChatInput {
+  categories: [String!]
+
+  """
+  Component schemas — array of { type, description?, group?, properties? } so the LLM knows valid props per type.
+  """
+  componentSchemas: JSON
+
+  """Current BoardModel JSON."""
+  currentBoard: JSON
+  knownTypes: [String!]
+  maxTokens: Float
+
+  """
+  Conversation history (latest user message at the end). For persisted sessions, only the last user message is appended; older are loaded from DB.
+  """
+  messages: [BoardAILLMMessageInput!]!
+  model: String
+  scopes: [String!]
+
+  """
+  Refids of components currently selected in the modeller (universal numeric handle, things-scene auto-assigned). For "selected" / "선택한" intent. Note: distinct from `id` which is a data-binding name.
+  """
+  selectedRefids: [Int!]
+
+  """
+  ChatSession id. Omit for ad-hoc (no persistence). When given, messages/patches are persisted.
+  """
+  sessionId: String
+  temperature: Float
+}
+
+type BoardAIChatOutput {
+  """Persisted ChatMessage id of the AI reply."""
+  assistantMessageId: String
+
+  """AI client identifier (provider:model)."""
+  clientId: String!
+
+  """Clarifying question when input is ambiguous."""
+  followUp: String
+
+  """BoardEditPatch."""
+  patch: JSON
+
+  """Persisted PatchEntry id (when patch was generated)."""
+  patchId: String
+
+  """Conversational reply."""
+  reply: String!
+
+  """Echo of session id (when persisted)."""
+  sessionId: String
+
+  """
+  Tool usages collected during agentic loop — sequence of {name, arguments, result, kind}. UI fold-able box for transparency / debug.
+  """
+  toolUsages: JSON
+
+  """Persisted ChatMessage id of the user input."""
+  userMessageId: String
+}
+
+input BoardAILLMMessageInput {
+  """Message content"""
+  content: String!
+
+  """Role: 'user' or 'assistant'"""
+  role: String!
+}
+
 """Represents a board that a user has marked as a favorite."""
 type BoardFavorite {
   """The timestamp when the board was created."""
@@ -921,12 +984,43 @@ input BoardTemplatePatch {
   visibility: String
 }
 
-input ChatCompletionInput {
+"""A single chat message in a ChatSession."""
+type ChatMessage {
+  """Message content"""
   content: String!
+  createdAt: DateTimeISO
+  id: ID
+
+  """ImportSession.id this message triggered (if any)."""
+  relatedImportSessionId: String
+
+  """PatchEntry.id this message triggered (if any)."""
+  relatedPatchId: String
+
+  """'user' | 'assistant' | 'system'"""
+  role: String!
+
+  """
+  Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.
+  """
+  toolUsagesJson: JSON
 }
 
-type ChatCompletionOutput {
-  message: String
+"""AI 협력 세션 — Board 와 1:1 결합. 메시지/패치 이력을 영속하여 컨텍스트 복원."""
+type ChatSession {
+  aiClientId: String
+
+  """Connected Board id (1:1)"""
+  boardId: String
+  createdAt: DateTimeISO
+  creator: User
+  domain: Domain
+  id: ID
+
+  """Compressed summary of older messages (for token saving)."""
+  lastSummary: String
+  updatedAt: DateTimeISO
+  updater: User
 }
 
 input CodeDecipherInput {
@@ -1434,6 +1528,27 @@ type DomainList {
   total: Int
 }
 
+"""An ownership record binding a User to a Domain (multi-owner support)."""
+type DomainOwner {
+  """Domain that the user owns."""
+  domain: Domain!
+
+  """When the ownership was granted."""
+  grantedAt: DateTimeISO!
+
+  """User who granted this ownership (audit)."""
+  grantedBy: User
+
+  """Unique identifier."""
+  id: ID!
+
+  """Optional reason/memo for granting ownership."""
+  reason: String
+
+  """User who owns the domain."""
+  user: User!
+}
+
 """Input type for updating an existing domain entity."""
 input DomainPatch {
   """Additional attributes for the domain in key-value pairs."""
@@ -1940,14 +2055,63 @@ input GroupPatch {
   name: String
 }
 
-input ImageCompletionInput {
-  count: Float!
-  description: String!
-  size: String!
+input ImportBoardAsyncInput {
+  """Apply Stage 4 (data binding)."""
+  applyBinding: Boolean
+
+  """
+  Attachment id of the source drawing file (uploaded via attachment-base).
+  """
+  attachmentId: String!
+
+  """ChatSession id when triggered from board-ai chat."""
+  chatSessionId: String
+
+  """Flip Y axis (CAD Y-up → scene Y-down)."""
+  flipY: Boolean
+
+  """Normalize coordinates so minX,minY=0"""
+  normalizeOrigin: Boolean
+
+  """Adapter parse options (excludeLayers, maxEntities, ...)."""
+  parseOptions: JSON
+
+  """Scale factor (e.g. 1 for mm:1unit)."""
+  scale: Float
+
+  """Registry scopes to use (board-import)."""
+  scopes: [String!]
 }
 
-type ImageCompletionOutput {
-  images: String
+"""도면 → 보드 변환 작업의 영속 단위 (비동기 진행상태 추적)."""
+type ImportSession {
+  """Attachment id (the source drawing file)"""
+  attachmentId: String!
+
+  """ChatSession id when triggered from chat (board-ai)."""
+  chatSessionId: String
+  completedAt: DateTimeISO
+  createdAt: DateTimeISO
+  creator: User
+  domain: Domain
+  id: ID
+  message: String
+
+  """Options used (parsed JSON)."""
+  options: JSON
+
+  """Progress percentage 0..100"""
+  progress: Float!
+
+  """Result (parsed JSON): { boardModel, stats, warnings }."""
+  result: JSON
+
+  """queued | parsing | mapping | assembling | binding | completed | failed"""
+  status: String!
+
+  """Total entities counted (when known)."""
+  totalEntities: Int
+  updatedAt: DateTimeISO
 }
 
 """
@@ -2002,6 +2166,11 @@ type InvitationList {
   total: Int
 }
 
+"""
+The `JSON` scalar type represents JSON values as specified by [ECMA-404](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf).
+"""
+scalar JSON @specifiedBy(url: "http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf")
+
 """
 A field whose value is a JSON Web Token (JWT): https://jwt.io/introduction.
 """
@@ -2417,10 +2586,21 @@ type Mutation {
     username: String!
   ): Boolean!
 
+  """Add a user as owner of the current domain."""
+  addDomainOwner(reason: String, username: String!): DomainOwner!
+
   """
   Attaches an existing contact to an employee. The contact is identified by its ID and the employee is identified by their ID.
   """
   attachContact(contactId: String!, id: String!): Employee!
+
+  """
+  썸네일이 없는 기존 첨부파일들에 대해 서버에서 썸네일을 일괄 생성한다. 한 호출당 limit 개까지만 처리하며, remaining > 0 이면 반복 호출 필요.
+  """
+  backfillAttachmentThumbnails(limit: Int = 20): ThumbnailBackfillResult!
+
+  """AI 주도 보드 모델링 — 자연어 채팅으로 보드 생성·구조편집·스타일링. sessionId 로 영속 컨텍스트."""
+  boardAIChat(input: BoardAIChatInput!): BoardAIChatOutput!
   cancelInvitation(email: EmailAddress!, reference: String!, type: String!): Boolean!
 
   """To clear translations cache"""
@@ -2931,6 +3111,9 @@ type Mutation {
     attributes: [AttributeSetPatch!]!
   ): Boolean!
 
+  """도면 → 보드 변환을 비동기로 시작. 즉시 ImportSession 반환, 백그라운드에서 처리."""
+  importBoardAsync(input: ImportBoardAsyncInput!): ImportSession!
+
   """Imports multiple boards from JSON files."""
   importBoards(files: [Upload!]!, groupId: String!, overwrite: Boolean!): [Board!]!
 
@@ -3027,6 +3210,11 @@ type Mutation {
   leavePlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
   multipleUpload(files: [Upload!]!): [Attachment!]!
 
+  """
+  Record a patch from user direct edit. Adds a system message so AI sees the change next turn.
+  """
+  recordDirectPatch(ops: JSON!, sessionId: String!, summary: String): PatchEntry!
+
   """To refresh oauth2 access token"""
   refreshOauth2AccessToken(id: String!): Oauth2Client!
 
@@ -3058,6 +3246,9 @@ type Mutation {
 
   """Releases a board, making it public and creating a version history."""
   releaseBoard(id: String!): Board!
+
+  """Remove a user from the owners of the current domain."""
+  removeDomainOwner(reason: String, username: String!): Boolean!
   renewApplicationAccessToken(id: String!, scope: String!): AccessToken!
 
   """Reorders a board between two adjacent boards by ID."""
@@ -3077,6 +3268,9 @@ type Mutation {
   """Reverts a board to a specific historical version."""
   revertBoardVersion(id: String!, version: Float!): Board!
 
+  """Mark a patch as reverted (does not undo, only flags)."""
+  revertPatch(patchId: String!): Boolean!
+
   """
   Runs a new scenario instance once and returns the result after it finishes.
   """
@@ -3084,6 +3278,9 @@ type Mutation {
   sendInvitation(email: EmailAddress!, reference: String!, type: String!): Invitation!
   singleUpload(file: Upload!): Attachment!
 
+  """Start (or get existing) AI chat session for a board. Idempotent."""
+  startBoardAISession(boardId: String!): ChatSession!
+
   """Starts a new scenario instance, which will run in the background."""
   startScenario(instanceName: String, scenarioName: String!, variables: Object): ScenarioInstanceStartResult!
 
@@ -4672,6 +4869,26 @@ type PasswordRule {
   useTightPattern: Boolean
 }
 
+"""One board edit operation history (cascade-deleted with ChatSession)."""
+type PatchEntry {
+  """AI confidence 0..1 (null for user-direct)."""
+  confidence: Float
+  createdAt: DateTimeISO
+  id: ID
+
+  """BoardEditOp[] (parsed JSON array)."""
+  opsJson: JSON!
+
+  """Whether this patch was reverted."""
+  reverted: Boolean!
+
+  """'ai' | 'user-direct' | 'import'"""
+  source: String!
+
+  """Short human summary of this patch."""
+  summary: String
+}
+
 """Logs the request and response payloads for API interactions."""
 type PayloadLog {
   """The timestamp when the log entry was created."""
@@ -4966,8 +5183,6 @@ type PropertySpec {
 }
 
 type Query {
-  APIDocCompletion(input: APIDocCompletionInput!): APIDocCompletionOutput!
-
   """To fetch a PDFTemplate"""
   PDFTemplate(id: String!): PDFTemplate
 
@@ -5222,7 +5437,18 @@ type Query {
   Retrieves boards that have been updated or soft-deleted since the given timestamp.
   """
   boardsUpdatedSince(since: DateTimeISO!): [Board!]!
-  chatCompletion(input: ChatCompletionInput!): ChatCompletionOutput!
+
+  """List chat messages of a session, oldest first."""
+  chatMessages(limit: Int = 100, offset: Int = 0, sessionId: String!): [ChatMessage!]!
+
+  """List patch entries of a session, newest first."""
+  chatPatches(limit: Int = 100, sessionId: String!): [PatchEntry!]!
+
+  """Get AI chat session by id."""
+  chatSession(id: String!): ChatSession
+
+  """Get AI chat session by board id."""
+  chatSessionByBoard(boardId: String!): ChatSession
 
   """
   Checks if the system is configured to provide a default password for new users.
@@ -5346,7 +5572,10 @@ type Query {
     sortings: [Sorting!]
   ): ContactList!
   customers: [Domain!]!
-  decipherCode(input: CodeDecipherInput!): CodeDecipherOutput!
+
+  """
+  Translate a cryptic system / framework / database error message into a concise, localized, actionable explanation for end users.
+  """
   decipherErrorCode(input: CodeDecipherInput!): CodeDecipherOutput!
 
   """To fetch a Department"""
@@ -5405,6 +5634,9 @@ type Query {
     sortings: [Sorting!]
   ): DomainLinkList!
 
+  """List owners of the current domain."""
+  domainOwners: [DomainOwner!]!
+
   """
   Fetches the list of available domain types from configuration. Only superusers are granted this privilege.
   """
@@ -5596,14 +5828,26 @@ type Query {
 
   """To query whether I have the given permission"""
   hasPrivilege(category: String!, privilege: String!): Boolean!
+
+  """
+  Translate an i18n JSON (key-value) from a source locale into multiple target locales. Source/target locales are configurable; defaults preserve historical "ko → en/ja/zh/ms" behavior.
+  """
   i18nCompletion(input: i18nCompletionInput!): i18nCompletionOutput!
-  imageCompletion(input: ImageCompletionInput!): ImageCompletionOutput!
+
+  """Get import session progress."""
+  importSession(id: String!): ImportSession
+
+  """List recent import sessions for a chat session."""
+  importSessionsByChatSession(chatSessionId: String!): [ImportSession!]!
 
   """To fetch integration Analyses"""
   integrationAnalysis: Object!
   invitation(email: EmailAddress!, reference: String!, type: String!): Invitation!
   invitations(reference: String!, type: String!): InvitationList!
 
+  """Check if a user is an owner of the current domain."""
+  isDomainOwner(username: String!): Boolean!
+
   """To fetch multiple LoginHistories"""
   loginHistories(
     """An array of filter conditions to apply to the list query."""
@@ -7226,6 +7470,21 @@ input ThemePatch {
   value: Object
 }
 
+"""썸네일 백필 결과"""
+type ThumbnailBackfillResult {
+  """이번 호출에서 처리 시도한 첨부 개수"""
+  attempted: Int!
+
+  """실패(생성 실패/콘텐츠 없음 등) 개수"""
+  failed: Int!
+
+  """이번 처리 후에도 남아있는 썸네일 미생성 후보 개수 (대략치). 0 이면 완료"""
+  remaining: Int!
+
+  """썸네일 생성·저장 성공 개수"""
+  succeeded: Int!
+}
+
 """The `Upload` scalar type represents a file upload."""
 scalar Upload
 
@@ -7408,6 +7667,8 @@ type UsersAuthProviders {
 
 input i18nCompletionInput {
   json: String!
+  sourceLocale: String
+  targetLocales: [String!]
 }
 
 type i18nCompletionOutput {