The Complete Developer Ecosystem

import {
  EntityNode, EntityMixin, EntityFactory, logger,
} from '@firebrandanalytics/ff-agent-sdk';
import type { UUID, EntityNodeDTO } from '@firefoundry/agent-sdk';

interface ArticleDTOData {
  title: string;
  url: string;
  snippet: string;
  analysis: string | null;
}

@EntityMixin({
  specificType: 'ArticleEntity',
  generalType: 'ArticleEntity',
  allowedConnections: {},
})
export class ArticleEntity extends EntityNode<any> {
  constructor(factory: EntityFactory<any>, idOrDto: UUID | EntityNodeDTO) {
    super(factory, idOrDto);
  }

  async analyze(): Promise<string> {
    const dto = await this.get_dto();
    logger.info(`Analyzing: ${dto.data.title}`);

    // Run AI analysis via a registered bot
    const result = await this.run_bot('AnalysisBot', {
      input: dto.data.snippet,
      args: { url: dto.data.url },
    });

    // Persist result back to entity graph
    await this.update_data({ ...dto.data, analysis: result });
    return result;
  }
}

import {
  RunnableEntity, BotRunnableEntityMixin,
  EntityMixin, EntityFactory,
} from '@firebrandanalytics/ff-agent-sdk';
import { AddMixins } from '@firefoundry/agent-sdk';
import { ReportBot } from '../bots/ReportBot.js';

@EntityMixin({
  specificType: 'ReportEntity',
  generalType: 'ReportEntity',
  allowedConnections: { Calls: ['ReportGenEntity'] },
})
export class ReportEntity extends AddMixins(
  RunnableEntity, BotRunnableEntityMixin,
)<any> {
  constructor(factory, idOrDto) {
    super(
      [factory, idOrDto],       // RunnableEntity args
      [new ReportBot()],        // Bot instance
    );
  }

  // Bridge entity state → bot input
  protected async get_bot_request_args_impl() {
    const dto = await this.get_dto();
    return {
      input: dto.data.user_prompt,
      context: new Context(),
      args: {
        plain_text: dto.data.document_text,
        orientation: dto.data.orientation,
      },
    };
  }
}

<agent id="SentimentWorkflow">
  <static-args>
    <arg name="topic" type="string"/>
    <arg name="analysis_type" type="string"/>
  </static-args>
  <run-impl>
    <yield-status message="Starting analysis"/>

    <call-bot name="SentimentBot" result="analysis_result">
      <arg name="topic" value="args.topic"/>
      <arg name="analysis_type" value="args.analysis_type"/>
      <arg name="mode">"detailed"</arg>
    </call-bot>

    <wm-set key="analysis/latest" value="analysis_result"/>

    <graph-append edge-type="ProducedAnalysis" target="self">
      <data>
        <field name="topic" value="args.topic"/>
        <field name="timestamp">
          <expr>new Date().toISOString()</expr>
        </field>
      </data>
    </graph-append>

    <return value="analysis_result"/>
  </run-impl>
</agent>