@agnocon/connector-sdk

Build and run AgnoCon workflow connectors.

Install

npm install @agnocon/connector-sdk

Create a connector package

import {
  createAction,
  createPiece,
  PieceAuth,
  Property,
  PieceCategory,
} from '@agnocon/connector-sdk';

export const myAction = createAction({
  name: 'do_thing',
  displayName: 'Do Thing',
  props: {
    input: Property.ShortText({ displayName: 'Input', required: true }),
  },
  async run(ctx) {
    return { ok: true, input: ctx.propsValue.input };
  },
});

const piece = createPiece({
  displayName: 'My App',
  auth: PieceAuth.None(),
  categories: [PieceCategory.OTHER],
  actions: [myAction],
});

export const myConnector = {
  id: 'my-app',
  ...piece,
  executable: true as const,
};

Host registration

import { ConnectorRegistry } from '@agnocon/connector-sdk';
import { myConnector } from '@agnocon/connector-my-app';

const registry = new ConnectorRegistry();
registry.register(myConnector);

await registry.execute({
  connectorId: 'my-app',
  actionId: 'do_thing',
  propsValue: { input: 'hello' },
});