Quickstart

import Cadenya from '@cadenya/cadenya';

const client = new Cadenya({ apiKey: process.env['CADENYA_API_KEY'] });
const workspaceId = process.env['CADENYA_WORKSPACE_ID']!;

const objective = await client.objectives.create({
  workspaceId,
  agentId: 'external_id:conference-attendee-generator',
  systemPromptData: {},
  firstUserMessage:
    'Create two conference attendee records with a name, email, phone, company, job title, city, and country. Return JSON.',
});

console.log(objective.metadata.id);

package main

import (
	"context"
	"log"
	"os"

	"go.cadenya.com/cadenya-go"
	"go.cadenya.com/cadenya-go/option"
)

func main() {
	client := cadenya.NewClient(
		option.WithWorkspaceID(os.Getenv("CADENYA_WORKSPACE_ID")),
	)

	objective, err := client.Objectives.New(context.Background(), cadenya.ObjectiveNewParams{
		AgentID:          "external_id:conference-attendee-generator",
		SystemPromptData: map[string]any{},
		FirstUserMessage: cadenya.String("Create two conference attendee records with a name, email, phone, company, job title, city, and country. Return JSON."),
	})
	if err != nil {
		log.Fatal(err)
	}

	log.Println(objective.Metadata.ID)
}

require "cadenya"

client = Cadenya::Client.new(api_key: ENV["CADENYA_API_KEY"])

objective = client.objectives.create(
  workspace_id: ENV["CADENYA_WORKSPACE_ID"],
  agent_id: "external_id:conference-attendee-generator",
  system_prompt_data: {},
  first_user_message: "Create two conference attendee records with a name, email, phone, company, job title, city, and country. Return JSON."
)

puts objective.metadata.id

curl "https://api.cadenya.com/v1/workspaces/${CADENYA_WORKSPACE_ID}/objectives" \
  -H "Authorization: Bearer ${CADENYA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
        "agentId": "external_id:conference-attendee-generator",
        "systemPromptData": {},
        "firstUserMessage": "Create two conference attendee records with a name, email, phone, company, job title, city, and country. Return JSON."
      }'

import Cadenya from '@cadenya/cadenya';

const client = new Cadenya({ apiKey: process.env['CADENYA_API_KEY'] });
const workspaceId = process.env['CADENYA_WORKSPACE_ID']!;

const objective = await client.objectives.create({
  workspaceId,
  agentId: 'external_id:conference-attendee-generator',
  systemPromptData: {},
  firstUserMessage:
    'Create one conference attendee record with a name and email. Return JSON.',
});

const stream = await client.objectives.streamEvents(
  objective.metadata.id,
  { workspaceId },
);

events:
for await (const event of stream) {
  const data = event.data;

  switch (data.type) {
    case 'toolCalled': {
      const called = data.toolCalled.tool;
      const name =
        called?.type === 'tool' ? called.tool.name :
        called?.type === 'agent' ? called.agent.name :
        '(built-in)';

      console.log(`Tool called: ${name}`);
      break;
    }
    case 'toolResult':
      console.log(`Tool completed: ${data.toolResult.toolCallId}`);
      break;
    case 'assistantMessage': {
      const content = data.assistantMessage.content;
      if (content) console.log(content);
      break;
    }
    case 'finalized':
    case 'cancelled':
    case 'timedOut':
    case 'error':
      break events;
  }
}

CADENYA_OBJECTIVE_ID="$(
  curl --silent \
    "https://api.cadenya.com/v1/workspaces/${CADENYA_WORKSPACE_ID}/objectives" \
    -H "Authorization: Bearer ${CADENYA_API_KEY}" \
    -H "Content-Type: application/json" \
    -d '{
          "agentId": "external_id:conference-attendee-generator",
          "systemPromptData": {},
          "firstUserMessage": "Create one conference attendee record with a name and email. Return JSON."
        }' |
    jq --raw-output '.metadata.id'
)"

curl -N \
  "https://api.cadenya.com/v1/workspaces/${CADENYA_WORKSPACE_ID}/objectives/${CADENYA_OBJECTIVE_ID}/events:stream" \
  -H "Authorization: Bearer ${CADENYA_API_KEY}" \
  -H "Accept: text/event-stream"