@kody/personal-capture

@kody/personal-capture

Intent

Tiny zero-OAuth onboarding example: save a short note (optional URL) into this package's packageStorage(), list recent captures newest-first, and optionally email a confirmation. Shows agents the package-owned storage pattern without secrets. Fork it so each account gets its own capture bucket.

When to use

• Stash a quick note or link for later (capture)
• List recent captures (listCaptures)
• Optionally notify yourself after a capture (notify: true)

Important

Platform @kody/* packages run live for every user, but packageStorage() is per package account. After you fork this into your own scope, captures stay in your fork's bucket. Prefer packages.invoke (or a fork) over a bare static import when you need this package's own storage.

Exports

• capture({ text, url?, notify? }) — save one capture; optional email confirm
• listCaptures({ limit? }) — newest-first list
• default export — namespace with the named helpers

Invoke tip

Named ESM exports work via static import { ... }. For keyless packages.invoke, use a subpath whose default export is the function (for example exportName: "getTopStories"), or call the root default dispatcher.

• Subpaths: capture, listCaptures (default exports for invoke after fork)

Example

import { packages } from 'kody:runtime'

export default async function main() {
	await packages.invoke({
		kodyId: 'personal-capture',
		exportName: 'capture',
		params: { text: 'Try Kody onboarding Step 2', url: 'https://heykody.app' },
	})
	return await packages.invoke({
		kodyId: 'personal-capture',
		exportName: 'listCaptures',
		params: { limit: 5 },
	})
}