seisei_intents 0.1.0-dev.2

Generic app action and intent bridge contracts for Seisei tools.

seisei_intents

Generic app-action and intent bridge contracts for Seisei tools.

This package maps ToolDefinition and ToolCall from seisei into host-app action definitions and invocations. It intentionally stays pure Dart so apps can test tool and intent behavior before adding Flutter/native platform code.

Apple App Intents remain native Swift source processed at build time. This package defines the generic contract and can generate conservative scalar Swift wrapper source from AppActionDefinition data. The optional packages/seisei_apple_intents Swift package provides the runtime helper types used by handwritten or generated App Intents.

const action = AppActionDefinition(
  id: 'create_note',
  title: 'Create Note',
  description: 'Create a note in the host app.',
  parameters: {
    'type': 'object',
    'properties': {
      'title': {'type': 'string', 'title': 'Title'},
      'priority': {'type': 'integer', 'title': 'Priority'},
    },
    'required': ['title'],
  },
);

final source = AppleAppIntentSourceGenerator.sourceForAction(
  action,
  shortcut: const AppleAppShortcutDefinition(
    phrases: ['Create a note in \\(.applicationName)'],
    shortTitle: 'Create Note',
    systemImageName: 'note.text',
  ),
);

Write the generated Swift source into an app, extension, framework, or Swift package target that Xcode compiles and indexes. The generator intentionally supports only string, integer, number, and boolean JSON schema parameters, with unsupported shapes reported as AppleAppIntentSourceException.

For a project-level generation step, create a manifest:

{
  "accessLevel": "public",
  "actions": [
    {
      "id": "create_note",
      "title": "Create Note",
      "description": "Create a note in the host app.",
      "typeName": "CreateNoteIntent",
      "parameters": {
        "type": "object",
        "properties": {
          "title": { "type": "string", "title": "Title" }
        },
        "required": ["title"]
      },
      "shortcut": {
        "phrases": ["Create a note in \\(.applicationName)"],
        "shortTitle": "Create Note",
        "systemImageName": "note.text"
      }
    }
  ]
}

Then generate Swift files into the host target:

dart run seisei_intents:generate_apple_intents \
  --manifest seisei_intents.json \
  --out ios/Runner/GeneratedIntents