luma/Sources/LumaCore/Agentic/ActionSpec.swift

import Foundation

public enum CodePreviewLanguage: String, Sendable, Equatable {
    case fridaJavaScript
    case fridaTypeScript
    case patternLanguage
}

public struct CodePreviewArg: Sendable, Equatable {
    public let field: String
    public let language: CodePreviewLanguage

    public init(field: String, language: CodePreviewLanguage) {
        self.field = field
        self.language = language
    }
}

public struct ActionSpec: Sendable {
    public var name: String
    public var description: String
    public var inputSchemaJSON: String
    public var isObserve: Bool
    public var requiresSession: Bool
    public var codePreview: CodePreviewArg?

    public init(
        name: String,
        description: String,
        inputSchemaJSON: String,
        isObserve: Bool,
        requiresSession: Bool,
        codePreview: CodePreviewArg? = nil
    ) {
        self.name = name
        self.description = description
        self.inputSchemaJSON = inputSchemaJSON
        self.isObserve = isObserve
        self.requiresSession = requiresSession
        self.codePreview = codePreview
    }

    public func toToolSpec(cacheBoundary: Bool = false) -> LLMToolSpec {
        LLMToolSpec(
            name: name,
            description: description,
            inputSchemaJSON: inputSchemaJSON,
            cacheBoundary: cacheBoundary
        )
    }
}

public struct ActionResult: Sendable {
    public var summary: String
    public var resultJSON: String
    public var attachments: [LLMAttachment]
    public var isError: Bool

    public init(summary: String, resultJSON: String, attachments: [LLMAttachment] = [], isError: Bool = false) {
        self.summary = summary
        self.resultJSON = resultJSON
        self.attachments = attachments
        self.isError = isError
    }
}

public struct ActionInvocation: @unchecked Sendable {
    public var args: [String: Any]
    public var mission: Mission
    public var sessionID: UUID?
    public var toolCallID: String

    public init(args: [String: Any], mission: Mission, sessionID: UUID?, toolCallID: String) {
        self.args = args
        self.mission = mission
        self.sessionID = sessionID
        self.toolCallID = toolCallID
    }
}