Cognotik | TaskUtils

⚙️ Kotlin Implementation


// Truncate large logs for UI
val displayLog = rawOutput.truncateForDisplay(10000)

// Safe completion with logging
task.safeComplete("Operation finished", logger)
// Triple Log Rule: UI, SLF4J, and Transcript
task.tripleLog(exception, logger, transcript, "Failed to process file")


// Resolve API credentials
val apiModel = chatModel.toApiChatModel() // Resolves keys

→

👁️ Runtime Behavior

// truncateForDisplay output:

[2023-10-27 10:00:00] INFO: Starting...
... (truncated for display, 4200 characters omitted)

// tripleLog Transcript Entry:

## Error: Failed to process file
Message: Connection reset

Stack Trace

...

// toApiChatModel result:

ApiChatModel(model=GPT-4, provider=OpenAI, key="sk-...", baseUrl="https://api.openai.com/v1")

Test Workspace Browser

Explore the artifacts and logs generated during TaskUtils unit testing.

Extension Functions

Function	Receiver	Description
`truncateForDisplay(maxLength)`	`String`	Truncates text and appends a count of omitted characters. Default 10,000.
`safeComplete(message, log)`	`SessionTask`	Attempts to complete the task with Markdown rendering; catches and logs exceptions to prevent crash loops.
`tripleLog(e, log, transcript, context)`	`SessionTask`	Logs to UI (error), SLF4J (error), and Transcript (Markdown with stack trace).
`toApiChatModel()`	`ChatModel`	Resolves API keys and base URLs from `UserSettings`. Throws `IllegalArgumentException` if key is missing.

Embedded Execution

When using Cognotik as an embedded engine (Headless mode), TaskUtils functions are critical for handling model resolution without a UI.


import com.simiacryptus.cognotik.apps.general.UnifiedHarness
import com.simiacryptus.cognotik.chat.model.OpenAIModels

val harness = UnifiedHarness(
    serverless = true,
    openBrowser = false,
    smartModel = OpenAIModels.GPT4o,
    modelInstanceFn = { apiChatModel ->
        // TaskUtils logic is used internally here to resolve keys
        val apiKey = System.getenv("OPENAI_API_KEY")
        apiChatModel.model!!.instance(key = apiKey)
    }
)

harness.start()

Custom Task Implementation


import com.simiacryptus.cognotik.plan.tools.safeComplete
import com.simiacryptus.cognotik.plan.tools.tripleLog
override fun run() {
    try {
        val result = doWork()
        this.safeComplete(result, logger)
    } catch (e: Exception) {
        this.tripleLog(e, logger, transcript, "Work failed")
    }
}

Test Workspace Browser

Extension Functions

Lifecycle & Logic

Embedded Execution

Custom Task Implementation